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Yes, visualize them. No ifs, ands 


or C++. 


There's real magic in Prograph CF 


pictorial programming environme 
Not just another pretty interface, | 
visual magic includes the actual 
down and dirty of programming 
itself. What's the payoff? Maximur 
productivity. 


Prograph CPX is the award- 
winning OOP tool of choice for 
client/server solutions, sophisticat 
multimedia authoring and all you 
development needs. Anc 
you wont have to charn 
any snakes to deliver 
killer applications in les 


time and with less mon 


Test drive Prograph 
absolutely free and 


experience why it’s th 
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And the ride of your life 


#1 rapid application 


development tool. 
Just call 


Ask for your magic CD-ROM ride. 


international 


P.O. Box 2206, San Francisco, CA 94126-2206 
Internet: info@prograph.com AOL: PrographUS 


™ © 1995 Prograph International. All other trademarks are 
the property of their respective holders. 
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Eddy Award Winner for Best New Developer Tool 
— MacUser Editors Choice Awards, 1993 


“A distinct improvement over ResEdit.” 
— MacTech /MacTutor 


“Resorcerer’s data template system is amazing!” 
— Bill Goodman, author of Compact Pro 


“Nuke ResEdit! Resorcerer is mission-critical for us.” 
— Dave Winer, Userland Frontier 


“The color pixel editors are wonderful! A work of art!” 
— Dave Winzler, author of Microseeds Redux 


“Every Macintosh developer should own a copy of Resorcerer.” 
~ Leonard Rosenthol, Aladdin Systems 


“Resorcerer will pay for itself many times over in saved time and effort.” 
— MacUser review 


“The template that disassembles ‘PICT’s is awesome!” 
— Bill Steinberg, author of Pyro! and PBTools 


“Resorcerer proved indispensible in its own creation!” 
— Doug McKenna, author of Resorcerer 


“a wealth of time-saving tools.” 
MacUser Review, Dec. 1992 


RESORCERER 
Version 1.2.4 The Resource Editor for the Macintosh Wizard 


e New ‘cicn’, ‘ppat’, ‘crsr’, ‘acur’, ‘pltt’, ‘clut’ editors 

orn ne ere ¢ Powerful oes family editing (all 9 icon types) 
¢ Color pixel anti-aliasing, dithering, and lots more 
Needs: >Mac Plus, > Sys 4.2, IMB ¢ Complete ‘PICT’ disassembly and reassembly 
Likes: >Mac Plus, > Sys 7.0, 2MB New 1.2 Features: °¢ ved ardent een ROM aioe browsing ia 

; ro. 1 e emplate field parsing types now supporte 
Oo e New Saeertion & deletion template field types 
e Text-only ‘PICT’ resources 
¢ Lots of improvements throughout 





Price: $256 (decimal) 
(Educational, quantity, or 


other discounts available) ¢ Easier, faster, more Mac-like, and more productive than ResEdit 


¢ Safer memory-based, not disk-file-based, design and operation 
Includes: 500 page manual e All file information and common commands in one easy-to-use window 
60-day Money-Back Guarantee ¢ Compares resource files, and even edits your data forks as well 
Domestic UPS ground shipping ¢ Visible, accumulating, editable scrap 
e Searches and opens/marks/selects resources by text content 
¢ Makes global resource ID or type changes easily and safely 
¢ Builds resource files from simple Rez-like scripts 
Extras (call ua): ° ee sae Hie meee to the clipboard a4 . 

° raphic editors support screen-copying or partial screen-copying 
COD, FedEx, UPS Blue/Red, e Hot linking Value ee for editing 32 bits in a dozen formats 
International Shipping ° Its own 32-bit List Mgr can open and edit very large data structures 
¢ Templates can pre- and post-process any arbitrary data structure 
¢ Includes nearly 200 templates for common system resources 
Downloadable Demos/Updaters: e TMPLs for Installer, MacApp, QT, Help, AppleEvent, OCE, GX, etc. 
AppleLink: Software Sampler ¢ Full integrated support for editing color dialogs and menus 
AOL: Software Libs/Development ¢ Try out balloons, ‘ictb’s, lists and popups, even create C source code 
CompuServe: MACDEV/Tbols e Integrated single-window Hex/Code Editor, with patching, searching 

P e Editors for cursors, versions, pictures, bundles, and lots more 

¢ Well-designed, helpful developer tools being added all the time 
¢ Relied on by thousands of Macintosh developers around the world 


Payment: Check, PO's, or Visa/MC 


or call us. 





MATHEMASSTHETICS, INC. 
P.O. Box 298 * Boulder * CO * 80306-0298 * USA 
Phone: (303) 440-0707 © Fax: (303) 440-0504 
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By Scott T Boyd, Editor 


I recently came across the following e-mail closing: 


“(Anxiously awaiting a protected memory MacOS)” 


We all know what he was getting at, don’t we? If only we had 
memory protection, life would be oh-so-much better. As often 
as we hear this, read this, and utter this, it must be true. 

Memory protection — it’s got to be good. Make sure that 
stray writes won't damage anything else, and the machine will 
stand solid as a rock, impervious to the vagaries of programmer 
error and lack of foresight. Let’s go march in front of Apple’s 
R&D center with placards, bullhorns, and riot police, and 
demand our memory protection now! 

paneaeceea 7. a supposed remedy, cure, or medicine for all diseases 

or ills; cure-all (Webster's New World Dictionary, 2nd College Edition] 
Memory protection sounds so good, but it’s a panacea, a holy 
grail. Now, that’s not to say that it’s necessarily a bad thing; far 
from it. Nevertheless, it’s not the solution. If it were, unix 
systems wouldn't crash, and wouldn’t get corrupted, but they do. 

What is the solution? I'll get to that, but for now consider 
this - fixation on a panacea can distract us to the point of 
missing real solutions. 

The writer of the e-mail I mentioned above listed a serious 
of difficulties he experienced recently while trying to install and 
use a complex environment. He also offered his workarounds. 
Let’s take a look at the problems. 

Crashes. Workaround — reinstall MacOS from scratch (clean 
install). Reason — system corruption from repeated crashes. 

Corrupted files and file system. Workaround — run 
Norton Utilities, Disk First Aid, and so forth. A bad file system 
often gets worse, so fix problems early and avoid more damage. 

Faulty system extensions. Workaround — remove 
suspect extensions. These can cause trouble whether they’re 
intact or corrupted. 

Unknown crashes. Workaround —- power down the 
machine for a few minutes. Reason — don’t know, but it seems 
to work sometimes when simple rebooting doesn’t. 

Incorrect parameter RAM settings. Workaround — zap 
PRAM. Reason — bad settings can result in improperly 
configured hardware and software. 

While this list isn’t complete, let’s see what we can quickly 
figure out about what’s happening here. 


Problem: corrupted system file. Possible causes include: 

¢ power or system failure during a write to the system file, 
due to “natural causes” or “human nature” (see below), 

¢ power or system failure before the file system cache is 
flushed to disk, or while a file is open 

e faulty hardware (SCSI termination, SCSI drive, cables, etc.) 
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e bad software changing the system file unintentionally or 
incorrectly. 

Problem: file system corruption. Possible causes include all of 
the above, as well as improper use of file system calls (e.g. it 
would be bad to write directly to any of a number of 
system-owned files). 

Problem: incompatibilities introduced by extensions. Possible 
causes are too numerous to mention. It’s hard to. write 
system software, and that’s what extensions are — system 
software. Extendibility makes the Macintosh interesting, and 
it comes with a price. 

Problem: Only a shutdown, power off, then restart solves 
problem. Typically caused by equipment problems 
(overheating, for example). Might also be that something 
needs to be reset but doesn’t except during a cold start. 

Problem: configuration settings improperly set. Probable cause? 
Someone or something writing to PRAM unintentionally or 
incorrectly. 

Back to the suggestion that protected memory will fix lots of 

problems — will it? 

Will it protect the file system from corruption in the event 
of power failure? system failure? Wouldn't that really require a 
robust file system? Perhaps a transaction-based system, 
complete with commit/rollback (ike most databases do)? 

Power failure comes in many forms. “Human nature” runs 
deep, and I’ve seen power failure result from inadvertent use of 
what looks very much like a floppy eject button on the front of 
certain models of Macintosh (e.g. my PowerMac 6100). My 18- 
month-old daughter, who seriously enjoys inserting floppies into 
floppy slots, one day put one into my 6100. 

When I explained that it can only hold one, and you have 
to take it out before you can put another in, she decided that 
she’d better get that first one out of there. Without hesitation, 
she reached right up to push the floppy eject button. The next 
60 ticks flowed by as slowly as a glacier’s movement as I 
(calmly?) said, “NO!” and rushed to avert disaster. 

If only I'd had protected memory, right? A system design 
along the lines of a PowerBook (such as a soft power switch 
and battery backup) might prove more efficacious. (Of course, 
moving the switch elsewhere might work, too!) 

Will memory protection defend against poorly-written 
system software? Having written some Apple system software 
myself, I can assure you that it’s entirely possible that Apple 
might accidentally ship some system software that has a bug in 
it. Not that I ever shipped any bugs (not on purpose, at any 
rate), but I did ship a few bug fixes, some for buggy Apple 
code, some for buggy 3rd-party code. Any errors in the system 
software may bring it to its knees, no matter what kind of 
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Piracy is the greatest threat to the world’s software industry. 


You only est thr | 
Developers lose billions in sales to software piracy each year. 
need Protect your software and get all the revenue you deserve. 


ib ee 
reason to protect with Sentinel: 


It’s the worldwide standard in software protection. 


More developers rely on Sentinel®, from Rainbow, 
than any other software protection in the world. 
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matters most: leading the industry in technology, 
quality, reliability and support. 


So when it’s time to protect your Macintosh 
application - and you need just-in-time delivery - 
protect with Sentinel. Protect with confidence. 





Call Rainbow for a Sentinel Developer's Kit and a FREE 
copy of “The Sentinel Guide to Securing Software.” 
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| Twelve Compilers! 
| CodeWarrior Gold includes twelve compilers and CodeWarrior Bronze includes four compilers. 
With our Power Mac-hosted 68K cross compilers, you can build both 68K and Power Mac apps 
on the Power Mac. Conversely, with our 68K Mac-hosted Power PC cross compilers 

you can build 68K and Power Mac apps on a 68K Mac. } 
Note: CodeWarrior compilers are shipped as fat binaries! 


Native IDEs! | 

The Code Warrior integrated development environment (IDE) 

is native on both the 68K Mac and Power Mac. The same 
easy-to-use environment is used to program in C, C++ and Pascal. 
Note: Code Warrior IDEs are also fat binaries. 


Get To Market Faster! 

Code Warrior compilers build your 68K and Power Mac apps at 
+200,000 lines/minute on a Power Mac 8100, with comparably 
high rates on less powerful Macs! 


eres Elaateld Two Free Updates! 


CodeWarrior is updated 3 times a year on CD-ROM. Purchase either 
of CodeWarrior and you are entitled to receive two future updates free of charge. 
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New Features! 
*MPW tools included for both the 68k and Power PC *Global optimization improved for the Power PC C/C++ compilers 
*C++ Templates supported in the compilers *Conditional breakpoints and expression evaluation added for the debugger 
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68K Mac Power Mac/ 68K Mac 


Power Mac-hosted Power Mac IDE: => (eo SRES eS 


Power Mac-hosted C/C++ generating PPC code 
Power Mac-hosted Pascal generating PPC code 
Power Mac-hosted 68K Mac IDE: 
Power Mac-hosted C/C++ generating 68K code 
Power Mac-hosted Pascal generating 68K code bd 
68K Mac-hosted Power Mac IDE: 
68K Mac-hosted C/C++ generating PPC code e 
68K Mac-hosted Pascal generating PPC code e 
68K Mac-hosted 68K Mac IDE: 
68K Mac-hosted Pascal generating 68K code @ e 
68K Mac-hosted C/C++ generating 68K code 
MPW Tools: 
Power Mac-hosted C/C++ generating PPC code 
Power Mac-hosted C/C++ generating 68K code e 
68K Mac-hosted C/C++ generating PPC code 
68K Mac-hosted C/C++ generating 68K code 
PowerPlant Application Framework 
PowerPlant Shared Library for Power Mac 
Source-level debugger for Power Mac 
Source-level debugger for 68K Mac 
Constructor Visual Interface Editor 
Selected Apple Developer Tools 
30-day money-back guarantee 
3,000 pages of On-line Documentation and 
much, much more. 
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By Dave Mark, MacTech Magazine Regular Contributing Author 


Adding Your Own Class to Sprocket, Part 2 


Where to hook in with a 
linked list class... 


Last month we created and tested a pair 
of classes that implemented a doubly 
linked list. This month we'll look at the 
process of adding the linked list classes 
to a Sprocket project. Our goal is to 
create a linked list when the application 
starts up, then add a link to the list 
every time a new document is created. 
Each link in the list would contain a 
pointer to a TDocument object. When a 
document is closed, its corresponding 
link is removed from the list. When the 
application shuts down, the list is 
deleted. 


PRE-FLIGHTING SPROCKET 
Before you add new code to Sprocket, 
your first job is to make sure you have 
the latest version of Sprocket, and that 
you can get it to compile. As you no 
doubt have discovered for yourself, 
Macintosh development environments 
have an unsettling habit of changing 
with each new release, breaking your 
code in the process. The biggest reason 
for this is that Apple continuously 
updates their interface files, sending a 
constant stream of updates to the 
various compiler vendors. As of this 
writing, the latest version of Sprocket 
was built to run with a pre-release 
version of Code Warrior version CW5, 
which includes a slew of new headers. 
Though you can get the new version of 
Sprocket to compile using older versions 
of CodeWarrior, it will take a fair amount 
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of work. Unfortunately, it would be impossible to continue to 
update Sprocket and to maintain compatibility with older 
versions of the various development environments. If you have 
any ideas about how we should be handling this problem, 
please send them along to our illustrious editor Scott (you can 
reach him at editorial@xplain.com). 

As we go to press, Symantec had not yet released a 
version of Symantec C++ with the new Universal Headers, 
though by the time you read this, they likely will have. Since I 
can’t compile Sprocket using Symantec C++, all the figures in 
this month’s column are based on CodeWarrior. Hopefully, 
Symantec will make the new headers available in time for next 
month’s column. 

When you go to any of the standard MacTech sites to 
download Sprocket (see p. 2), there are two archives you'll need. 
One should be called something like “Sprocket.12-15-94.sit” and 
the other something like “SprocketSample.12-15-94.sit”. The date 
in the middle is the date the archive was created, and should be 
about three months earlier than the date this article appears. The 
Sprocket archive contains the files that make up the Sprocket 
framework. The SprocketSample archive contains a few 
additional source code files, as well as a project file that brings 
the Sprocket and SprocketSample source together. The idea here 
is that Dave Falkenburg maintains Sprocket, while I maintain 
SprocketSample. Sprocket is a framework, while SprocketSample 
is an application that brings the framework to life. [Youll be able 
to find the 12-15-94 versions, as well as any more recent releases 
at the online sites — ed stb/ 

Create a Sprocket folder on your hard drive, download 
and decompress the two archives, and copy each of the new 
folders into the Sprocket folder. Be sure each of the two 
folders has a date. This will distinguish the current Sprocket 
and SprocketSample folders from the versions you'll download 
in following months. Figure 1 shows my master Sprocket 
folder. It contains one subfolder with the current version of 
Sprocket and another with two different versions of 
SprocketSample. The “before” folder contains all the 
SprocketSample code before I added in the list classes. The 
“after” folder contains the same program, this time with the list 
classes integrated in. We'll start by getting the “before” version 
of SprocketSample to compile. Next, we'll go through the 
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process of converting the “before” version to the “after” 
version, then compile and run the “after” version. 


“Size | Kind 


> Ca Sprocket, 12/15/94 

wv (2 SprocketSample, 12/15... 

> C3 SprocketSample, After 
C3 SprocketSample, Before 





Figure 1. My master Sprocket folder, showing the folders for 
Sprocket and for SprocketSample. 


COMPILING THE “BEFORE” VERSION OF SPROCKETSAMPLE 


Each SprocketSample project is divided into two parts. The 


first part (the upper half of the project window) contains 


references to SprocketSample source code, while the second 
part (the lower half of the project window) contains references 
to Sprocket source code (Figure 2). 


SprocketSampleHeaders68K .pch++ 
SprocketSample.cp 

Doc Window .cp 

ToolWindow .cp 

PreferencesDialog Window .cp 
MailableDoc Window .cp 


Bee80e5) 
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SprocketMain.cp 
AppleEventHandling.cp 
Dialog Window .cp 
DialogUtils.cp 
DragUtils.cp 

Mailable Window .cp 
Preferences.cp 
PrintingUtils .cp 
Splash window .cp 
Window .cp 

MacOS .lib 

CPlusP tus .lib 
StandardMenus_.rsrc 
Sprocket.rsre 
CreditsBox.rsrc 


* 
* 
* 
> 
* 
e 
* 
* 
+ 
+ 
* 
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Figure 2. The 08K CodeWarrior version 
of the SprocketSample project. 


To get the code in your SprocketSample project to 
compile, you’ve got to make sure the compiler can find all of 
the project’s files. If you are using CodeWarrior, launch either 
the PowerPC or 68K project, select Preferences... from the Edit 
menu, then scroll down to and click on the Access Paths icon 
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(Figure 3). The rectangle labeled User: shows the paths that 
will be searched for source code files. The rectangle labeled 
System: shows the paths that will be searched for things like 
system include files. You want to make sure that the User: 
rectangle contains one additional path besides that leading to 
the project folder. The additional path is the folder containing 
the Sprocket source code. If this second path is there, but is 
wrong, click on it and press the Change button, then navigate 
into and select the folder containing the Sprocket source code. 
If the second path is there and looks good, just leave it alone. 
If there is no second path, click on the Add button and select 
the folder nae the tpi source code. 


Additional Access Paths: 
Cl] Treat *inciade <...> as *include e 


<< PROJECT FOLDER >> i 


a | 
= 
I< <5 ne 2 ee sae See fe eae emer ores ' 


Sees 
Soe 


<< COMPILER FOLDER >> 





Figure 3. The CodeWarrior Access Paths preferences panel. 


The point is, you want to make sure the compiler can find 
the Sprocket source code as well as the SprocketSample source. 
You know that the compiler will find the SprocketSample 
source code since it is in a subfolder inside the project folder. 
Once your new folder appears in the User: rectangle, click the 
OK button to save your preferences. 

Next, you'll need to make sure that your CodeWarrior 
project includes the proper precompiled header file. If you 
look at the project window shown in Figure 2, the very first file 
in the project is named SprocketSampleHeaders68K. pcht+. 
This file is a source code file which will be precompiled, then 
used to compile all the other source files in the project. By 
precompiling all the #includes and j#fdefines used by all 
your source code files, you can significantly reduce your 
compile times. 

When CodeWarrior encounters a project file that ends in 
“pch++”, it compiles the file into a precompiled header, saving 
the header in the same folder as its corresponding “.pch++” file. 
Select Preferences... from the Edit menu, then scroll down to 
the Language preferences. The Prefix File field tells the 
compiler which precompiled header to use when it compiles 
the project source code files (Figure 4). Make sure that the 
field contains either SprocketSampleHeaders68K or 
SprocketSampleHeadersPPC, making sure it matches the 
“pcht++” file in your project. 
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Apply to open project. 


Source Model:[ Custom _v] 
Language Info: 
Ci Activate C++ Compiler ([[] ANSI Strict 
C] ARM conformance C] ANSI Keywords Only 
C] Direct Destruction (] Expand Trigraphs 


DB ® 

Lisent Anas CO MPw Newlines 

C] Pool Strings C] MPW Pointer Type Rules 
() Bon't Reuse Strings Ci] Enums Always Int 


C] Require Function Prototypes 





Figure 4. CodeWarrior’s Language preferences pane. 


If you are using Symantec C++, you'll have to address 
these same issues and get hold of the latest Universal Headers. 
That’s about it. You are now ready to take the “before” version 
of SprocketSample for a spin. Once you get everything to 
compile, you'll see the familiar splash screen, menu bar, and 
empty tool palette window. Once you've had a chance to play 
with SprocketSample for a bit, quit and let’s add our list classes 
into the mix. 


ADDING THE LIsT CLASSES 
Just as a reminder, here are the two linked list class definitions. 
TLinkedList is the linked list itself and TLink is a single 
link: 





class TLinkedList 
{ 
public: 
TLinkedList(); 

virtual ~TLinkedList (); 
virtual OSErr CreateAndAddLink( void *objectPtr ); 
virtual OSErr FindAndDeleteLink( void *objectPtr ); 
virtual unsigned long CountLinks(); 
virtual void *GetNthLinkObject( unsigned long 


linkIndex ); 


protected: 
virtual void DeleteAllLinks(); 
TLink *FindLink( void *objectPtr ); 
virtual OSarr DeleteLink( TLink *linkPtr ); 
TLink *TPirstLinkPtr: 
TLink *fLAastLinkPtr: 





i3 


class TLink 
{ 

public: 
TLink( void *objectPtr ); 
~TLink()% 
SetPrevLink( TLink *prevLinkPtr ) 
fPrevLinkPtr = prevLinkPtr; } 
SetNextLink( TLink *nextLinkPtr ) 
fNextLinkPtr = nextLinkPtr; } 
virtual TLink *GetPrevLink () 
return fPPrevlinkPtirs J 
virtual TLaink *CetNextLink () 
return fNextLinkPtr; } 
*GetObjectPtr() 
return fObjectPtr; } 


virtual 
virtual void 


Virtual void 

















virttal youd 
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protected: 


TLink *fPrevLinkPtr; 
TLink +7 NeXT LINK te: 
void *fObjectPtr; 


The first thing you'll need to do is copy the four source 
code files that make up the TLinkedList and TLink classes 
into the same folder as the SprocketSample source code. In 
this case, you'll copy the files LinkedList.cp, 
LinkedList.h, Link.cp, and Link.h into the 
SprocketSample folder located inside the folder named 
SprocketSample, Before. Be sure to add Link.cp and 
Li8nkedList.cp to the first half of the project window. 

Next, you'll need to modify SetUpApplication() to 
create a new TLinkedList object and 
QuitApplication() to step through the list and close all the 
documents stored in the list. You'll also need to create a global 
variable containing a pointer to the TLinkedList object. To 
do that, create a file called SprocketSample.h and type in 
the following code: 


#include "LinkedList.h" 
extern TLinkedList *gListPtr; 


Save SprocketSample.h in the same folder as all the other 
SprocketSample source code. 

Next, open the file SprocketSample.cp and add these 
two lines at the top: 


#include "SprocketSample.h" 
TLinkedList ‘*gListPtr; 


Now scroll down to the first routine in 
SprocketSample.cp, which should be 
SetupApplication(). Here’s where you'll create a new 
TLinkedList object. Add this line at the beginning of 
SetupApplication(): 


gListPtr = new TLinkedList; 


Scroll down about 4/5 of the way down in 
SprocketSample.cp and find the © routine 
QuitApplication(). Change the routine so it reads like this: 


Boolean QuitApplication(void) 


f 
L 


unsigned long numLinks, counter; 
TDocWindow *myDocPtr; 
OSErr err; 


numLinks = gListPtr->CountLinks() ; 
for ( counter=l1; counter<=numLinks; countertt ) 


f 
l 


myDocPtr = (TDocWindow *)gListPtr->GetNthLinkObject( 1 ); 
// If the user cancels the close, return false to cancel the quit... 
if ( ! myDocPtr->Close() ) 
return false; 
else 
delete myDocPtr; 
} 


return true; 
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The main purpose of QuitApplication() is to step 
through the list of documents, sending each document object a 
close message. If a document has changed since it was last 
saved, its close method will give the user a chance to cancel 
the close. If the close is canceled, we'll exit the loop by 
returning false, thus canceling the quit. If the user doesn’t 
cancel a close, the TDocWindow object under consideration is 
deleted. 

A few things worth noting here. Notice that we delete the 
TDocWindow but don’t remove it from the list first. That is 
done in the TDocWindow destructor. Deleting it from the list 
inside the TDocWindow destructor has two advantages. First, 
this keeps us from having to remember to delete the TLink 
every time we delete a TDocWindow. Secondly, this ties the 
deletion of the link as closely as possible to the actual deletion 
of the TDocWindow, keeping us from the nasty situation where 
we have a TDocWindow that isn’t in the list or where we have 
a TLink that points to a TDocWindow that’s already been 
deleted. 

Take some time to look through the code that closes 
documents. Look in SprocketMain.cp at the code that 
handles clicks in a window’s close box and at the code that 
handles the Close and Quit menu items. Also check out the 
code that responds to the quit application Apple event. This 
code will probably change slightly in the future, but it won’t 
change by much. The most likely change is to merge all the 
above-mentioned code so that it all closes documents the exact 
same way. 

Our final task is to modify the TDocWindow constructor 
and destructor. The constructor needs to embed a pointer to 
the new TDocWindow in a TLink, adding the TLink to the 
list pointed to by gListPtr. The destructor needs to find the 
TLink containing the TDocWindow about to be destroyed, 
and remove that link from the list. 

Before you edit the constructor and destructor, you'll need 
to add this line to the beginning of DocWindow. cp: 


#include "SprocketSample.h" 


This will give you access to the global gListPtr as well as to 
the TLinkedList class. 
Now add these three lines to the end of the 
TDocWindow() constructor: 
err = gListPtr->CreateAndAddLink( this ); 
if ( err != noErr ) 
DebugStr((StringPtr) "\pAdd Doc to list failed"); 
The first line adds a pointer to the current object to the list, 
while the second two lines drop us into MacsBug if the add 
failed. 
Add these three lines to the ~TDocWindow() destructor: 
err = gListPtr->FindAndDeleteLink( this ); 
if (err != noErr) 
DebugStr((StringPtr) "\Delete doc from list failed"); 
The first line deletes the TDocWindow from the global linked list. 
The second two lines drop us into MacsBug if the delete fails. 
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RUNNING THE NEW, IMPROVED SPROCKETSAMPLE 


OK, now that all your changes are in, run your new version of 
SprocketSample (or, if you just can’t wait long enough to type 
in the changes, run the version of SprocketSample in the 
SprocketSample, After folder). Select New from the File 
menu and create 3 new documents. Next, click in the close 
box of the frontmost window. You'll be prompted to save the 
changes in that window. Click the Save button. 

Now select Quit from the File menu. Once again, you'll be 
prompted to save changes in a document, but this time you'll 
be prompted to save the changes in the first document in the 
global TLinkedList, which should be the document named 
“Untitled-1”. If you click the cancel button, the quit should be 
aborted and you should be left running as you were before you 
selected Quit. 

Experiment with various cancel and saving combinations. 
Try sending a quit application Apple event to SprocketSample 
by launching this script from the Script Editor: 
tell application "SprocketSample.68K" 

quit 
end tell 

Be sure to change the name of the application in the tell 
clause if you are not running with the 68K version of 
CodeWarrior. Use the debugger to follow the code. Though 
Sprocket might seem a little intimidating, it’s really not that hard 
to follow once you get into it, especially if you confine yourself 
to a specific functional area or thread. 


Untit NEXT MONTH 
In next month’s column, we’ll look into Sprocket’s menu 
handling model and add our own menus to Sprocket’s menu 
bar. The current plan is to replace the existing menu- 
processing code with a new design that more closely 
approximates that used by OpenDoc. The idea is, if you learn 
how to handle menus in Sprocket, you'll have a leg up when 
you start writing your first OpenDoc part. 





To receive information 
on any products 
advertised in this issue, 


send your request 
via Internet: 
productinfo@xplain.com 
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Bringing software into the world is a little 
like bringing up children. You always know 
where they start, but you seldom know 
where they’ll end up. These days, with 
illegal use of software so common, 
concerned developers have good reason to 
worry about the products of their labor. 
That’s where MacHASP comes in. 





Like a responsible babysitter, MacHASP 
accompanies your software wherever it goes. 
With MacHASP there, your software won’t 
run out of control. Without MacHASP, in 
fact, your software won’t run at all. 


For developers, MacHASP provides the 
highest level of security and reliability. 

For legitimate users, MacHASP is a friendly 
and transparent solution. Once connected, 
they won’t even feel it’s there. 


And if your child wants to play with 

its friends, a single Net-MacHASP lets it 
run free around a local area network. But 
always under your supervision and control. 


Get serious about software 
protection. Since 1984, nearly one 
million HASP keys have enabled thousands 
of PC & Mac software developers, in more 
than 60 countries, to protect their software. 
To find out why MacHASP is considered the 
best product in the market, order your 
MacHASP Developer’s Kit today. 


1-800-225-4277 
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The Professional's Choice 


North Aladdin Software Security Inc. 
America Tel: (800) 223 4277, 212-564 5678 
Fax: 212-564 3377 
E-mail: sales@hasp.com 


Intl Office Aladdin Knowledge Systems Ltd. 
Tel: 972-3-537 5795, Fax: 972-3-537 5796 
AppleLink: ALADDIN.KNOW 
E-mail: aladdin @ aladdin.co.il 


United Aladdin Knowledge 
Kingdom Systems UK Ltd. 
Tel: 0753-622266, Fax: 0753-622262 


France Aladdin France SA 
Tel: 1 40 85 98 85, Fax: 1 41 21 90 56 
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C/C++ without Object Master 














pen your eyes to Object Master’ the most 
innovative programming tool available on the 
market today. With its powerful editors and 
intuitive windows, Object Master gives you 
the unsurpassed freedom to develop code quickly 
and accurately. 


A Real Eye Opener 
Use Object Master's unlimited number of browser 
windows to access code components and display 
their definitions, ready for editing. All changes you 
make in the browser windows are automatically 
displayed 
throughout the 
environment, 
consistently 
ensuring current 
and accurate 
code. With the 
browser windows, 
you can also 
———— view a class list 
cai displaying the 
hierarchical relationships between classes, and use 
pre-made templates to create classes and methods. 





Picture Perfect Code 

While the browser windows let you edit specific 
pieces of code, Object Master’s File editor gives 

you a full-file view of your code, allowing you to 
quickly perform universal edits. 

To help you identify important pieces of code 
easily, Object Master color codes and formats 
language elements. With a single keystroke, 
Object Master will look up parameters for methods 
or functions contained in the project and paste 
them directly into your source code. 


Improved Insight 

Don't worry about the physical location of your 
code—Object Master parses all files and maintains 
a data dictionary of project components. The 
dynamic environment updates your entire project 
eae) as you edit without ur complain! 
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i |: | CreateDrawObject 
--CMy AreaAction = DoShowFeedback 
---CMyEllipseAction }-4| GetDescriptionindex 
=CMyRectaAction 
---CMyRRect Action 
Cit eeasiue 
-ePaintToo! 
DrawToo! 
lai aser Tool 


Senay MouseAction->CMyAreadction-»>CMyRectAction 


class CMyLineAction ‘ public ie CryMouseRet ion 
{ 


aaah 

t : osBRLV | ewe meres 
oir taal hu 
virtual BR_Chul tistringL ist: en 
virtual ie ee ect* crea! shra 
virtual void DoS 
virtual void DeConst 


& ay =u 
neBR EP oi i nite currentPoint); 





True browser windows let you see code like never before. 


Object Master provides you with all the editing 
and navigational capabilities you require to write 
code productively. For example, the Class Tree 
window graphically displays your project’s class 
hierarchy and allows you to expand and collapse 
“branches” and open multiple windows displaying 
specific code components. 


Power Macintosh Support 
ACT offers two versions of this outstanding 
programming tool: Object Master and 

Object Master UNIVERSAL. Both run on the 
traditional 68K-based Macintosh computer and 
the new Power Macintosh, taking full advantage 
of the features of each platform. 


Introducing a powerful new way of looking at code development. 


Object Master supports C and C++ and works 
seamlessly with Symantec’s THINK Project 
Manager and Metrowerk’s CodeWarrior. Separate 
versions are available for the 68K-based Macintosh 
and the new Power Macintosh computers. 

Object Master UNIVERSAL supports C, C++, 
Pascal, Modula-2, and all major compilation 
systems. It can be installed on both the 68K-based 
Macintosh and the new Power Macintosh. 











1H 1 pages 


“\. Object Master pays for itself in a week, even at 
suggested retail price.” —Macworld Magazine 


See Object Master for Yourself 
Call (800) 384-0010, and we'll send you a free 
demo disk of Object Master—because seeing 

- really is believing. 





ACI US Inc. 20883 Stevens Creek Blvd., Cupertino, CA 95014 


Tel. 1 408 252 4444. Fax 1 408 252 0831. AppleLink D4444 
©1994 ACI US, Inc. All product or service names mentioned herein are 
trademarks of their respective owners. Quote reprinted courtesy of 
Macworld Communications, 501 Second Street, San Francisco, CA. 94107 





By Jesse Feiler, Philmont Software Mill 





Apple Guide Isn’t Help 





... dt is something much 
more interesting... 


fj you doubt that statement, take a look 
at Figure 1, showing Apple Guide 
assistance at work. In this screen shot, an” _ — 
you see an Apple Guide panel and an LS eee I 
ever-popular Apple Guide coach mark. 
Yes, this could be traditional help — but 
the coach mark and the “Oops” in the 
Apple Guide panel belie that. Apple 
Guide doesn’t just tell you things — it 
provides active assistance to you as you 
do them. 

“Active” is the keynote here. That 
coach mark will circle the “Color 
intervals” chapter button no matter 
where it is on the screen: move the —— 
Controller, scroll the list of chapters — After the folder opens, click Continue. 
that coach mark will be where it should CL 
be. And that “Oops” in the Apple Guide 
panel is another sign of Apple Guide’s 


Oops You must select Chapter XIV: “Color Intervals” 
on the Controller. 





-_ | Figure 2 
activity - Apple Guide was watching to 
make sure you followed the instructions 
correctly, and warned you when you In the world of software, “help” can be a bad word, 
made a mistake. carrying with it connotations that are far from positive. From the 
Figure 2 shows another form of software developer’s point of view, “help” for users implies that 
Apple Guide’s activity, and another way the software is complicated or even (gulp!) not designed well. 
in which Apple Guide can handle the We all spend enormous amounts of time making our products 
case where you don’t follow instructions simple, clear, and easy-to-use. Adding “help” suggests that these 
correctly. Apple Guide actually does the efforts have been less than complete. 
task for you. This certainly isn’t the “help” From the user’s point of view, asking for help suggests that 
that you’re used to in computer programs. you aren’t able to do something that you should be able to do. 


Jesse Feiler — Jesse is Software Director of Philmont Software Mill, and author of Real World Apple Guide. You can reach him 
in the Philmont Software Mill area of eWorld (shortcut “Philmont”). 
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Some people have tremendous difficulty asking for help under 
any circumstances — even when the help is electronic. The 
endless anecdotes of drivers who refuse to ask for directions 
and the innumerable sitcoms featuring characters from Lucy to 
Archie to Murphy who refuse to ask for help and thereby create 
all sorts of havoc for thirty minutes just illustrate this point. 

Rather than think of Apple Guide as help (which it isn’t), 
think of it as service — a rare (so far) luxury that far from 
embarrassing, annoying, or frustrating you makes you feel 
wonderful. Service is a personal transaction, provided one-on- 
one. It requires an understanding of what a person is 
attempting to do and what he or she is likely to do next. By its 
nature, Apple Guide assistance provides different assistance to 
different people at different times. Service at its best is 
unobtrusive but always available. “Service” reminds us that it is 
the computer that serves us; that the machine should adapt to 
the needs of the user. As opposed to “help” which may 
connote difficulty, incompetence, or lack of skills, “service” is 
always a positive experience. 

Note the emphasis on people and what they are doing. 
There is a big distinction between the tasks that people do 
(which are generally things they are interested in) and the tools 
that they use to do those tasks (which they generally are 
interested in only when something goes awry). It may be a 
shock to you, but people usually don’t want to use your 
software (well, your parents do, but...). People want to write 
letters, play computer games, and send messages. 

Apple Guide really isn’t about computers at all: it’s about 
something much more interesting — people. Now maybe you 
actually are much more interested in computers and in writing 
software than you are in people and their behavior. That’s OK, 
and it’s one of the things that makes the world an interesting 
place. But there’s one very important thing to remember about 
people, one particular behavior in which they partake that even 
the most computer-centric developer must acknowledge: they 
buy software and write paychecks. So get out that installation 
disk and re-install Apple Guide: it takes 2MB of disk space (far 
less than a word processor), and almost no memory when it’s 
not in use. 

In this very brief overview of Apple Guide, you'll see the 
types of assistance that Apple Guide can provide as well as 
some of the opportunities with Apple Guide. /See the end of the 
article for information on Jesse’s upcoming book on Apple Guide 
— ed stb/. 


TYPES OF ASSISTANCE 
You can do many things with Apple Guide, but guide files are 
usually divided into four main types: tutorials, help, shortcuts, 
and a grab-bag of others. 

Tutorials walk the user through a task step-by-step. These 
guide files can replace much documentation that previously 
would have been printed, and can be much more effective. If 
you have worked on instructional documentation for software, 
you have probably had the rather time-consuming task of 
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creating, assembling, and printing screen shots to illustrate the 
steps involved in a task. Often the screen shots need to be 
adjusted or modified, with arrows pointing to interface objects 
and text identifying them. And then just when you get it right, 
the interface changes just a bit and all the screen shots in your 
manual are out of date. With Apple Guide, the learning 
experience is directly with the application. There are no screen 
shots to worry about — you specify Apple Guide coach marks 
and the actual interface elements are identified. If they change 
size or shape or move around, Apple Guide just draws the 
coach mark in a new location. Now how much drudgery does 
that one feature save? 

From the user’s point of view, Apple Guide’s active assistance 
means that the tutorial can function as a true teacher. Back in the 
1950’s, Dr. B. F. Skinner wrote about teaching machines that 
would present a single concept, test that the student understood it, 
and then proceed to the next concept — only when the teaching 
machine was satisfied that the student had indeed mastered the 
idea. It may have taken a little while, but we finally have 
implemented this concept. Apple Guide provides a number of 
features that can help the student learn. In addition to watching to 
make certain that the user has done the right thing, Apple Guide 
can easily provide further assistance if the user needs it — the Huh? 
Button shown at the bottom of the panel in Figure 1 can be 
enabled to provide a doorway to more information if the user 
wants it. And the user proceeds at whatever pace is convenient — 
even stopping if necessary. All Apple Guide panels have a close 
box: you never get trapped in a guide file. 

While Apple Guide isn’t help, it can provide help as one of 
its services. Guide files that provide help have a different 
behavioral aspect from tutorials. Whereas Tutorials coach the 
user step-by-step through the task, Help guide files often are 
much more focused on a result than on a process. Each has its 
place. In a real-world example of this sort of behavior, a person 
(who shall remain nameless) does not know how to FIP files 
from the Internet, and asks someone else in the office to do it 
whenever necessary. As a New Year’s resolution, the party 
involved promised that in the New Year he would learn how to 
FTP files from the Internet himself. Apple Guide could provide 
either type of assistance: the first, simple help is of the “do it for 
me” type; the second, which would be a tutorial is of the “teach 
me step by step how to do it so I can do it myself next time.” 

The third type of guide file is a Shortcuts file. These files 
provide the information that is usually found on keyboard 
overlays, back covers of manuals — and little notes stuck on the 
side of the monitor. The behavior associated with a tutorial 
guide file is generally a fairly lengthy interaction in which the 
user does things step by step, the behavior associated with a 
help guide file is fairly brief, and often Apple Guide actually 
does the task for the user. The behavior associated with a 
shortcuts file is different again: it is relatively brief, but the user 
will generally do the task in the end. 

The last type of guide file is a hodge-podge group called 
Other guide files. These include promotional guide files that 
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Consumer 
Information 
Catalog 


The Greatest Thing 
Since Sliced Bread 


No matter how you slice it, our free Consumer 
Information Catalog is great food for thought. 

The Catalog dishes up more than 200 free and 
low-cost government booklets on subjects you can 
really sink your teeth into — such as staying 
healthy, eating right, finding a job, getting federal 
benefits, using credit, buying a home, helping your 
kids, taking care of your car, and much, much more. 

To get your free copy, send your name and 
address to: 





Consumer Information Center —_ wy 
Department GT = 


Pueblo, Colorado 81009 





A public service of this publication and the Consumer Information 
Center of the U.S. General Services Administration 






You Cant Buy This CD 
in any Store 


More than 30 popular SDKs—one low price 


You won't find this special 
Mac OS SDK in any store or catalog. 
It’s available only from APDA, Apple’s 
source for development tools. Nor will 
you be left on your own as soon as you 
make the purchase. Every quarter you'll 
receive an automatic update—ensuring 
you always have the most current 


What's the easiest and least costly 
way to make the most of the new 
features enabled by Macintosh 
system software extensions? 

In a word (or five), the Mac” 
OS Software Developer’s Kit (SDK). 

The Mac OS SDK helps you 
support the entire Mac OS family, 


by offering instant access to more Mac OS ee! = information as well as an understanding 
than 30 of Apple’s most proven Software Developer's Kit = of how to add support for advanced 





and popular SDKs. And whereas system extensions in your software. 
these SDKs previously sold separately for nearly $2,000, A typical SDK provides the system software extension; 
now you can have them all on one CD—for a one-year programming interfaces and libraries; sample code; and 
subscription price of only $299, technical documentation. Here’s a listing of the SDKs that 


are included in your first CD mailing: 











Apple Guide AppleTalk Wide Area Macintosh Easy Open Open Transport 
Apple Open Collaboration ColorSync MacODBC PlainTalk 

Environment (AOCE) Communications Toolbox MacOSI Connection QOuickDraw GX 
Apple Remote Access Control Strip MacSNMP QuickTime 
Apple Remote Access Modem _ Designing PCI Cards & MacTCP 
Apple Shared Library Manager _ Drivers MacX.400 Sound Manager 
AppleScript File System Manager MacX25 Telephone Manager 
AppleSearch Installer MIDI Management Tools Thread Manager 
AppleShare API Macintosh Drag and Drop Network Software Installer XTND 
liens 
How to Order Mac OS SDK } order by mail: send a check or money order for $299 payable to 
}® order by phone: call 1-800-282-2732 (U.S.) APDA/Apple Computer, Inc., plus sales tax and $20 for shipping and 
1-800-637-0029 (Canada), or (716) 871-6555 (International) handling (for U.S. orders) to: APDA, Apple Computer, Inc., P.O. Box 
Monday through Friday, 7am to 5pm PST. 319, Buffalo, NY 14207-0319. For international orders, please call APDA for 
RO6O3LL/A $299 per annual subscription (four mailings). shipping and handling charges. Allow 5-10 days for delivery within the U.S. 


© 1995 Apple Computer, Inc. Apple and the Apple logo are registered trademarks of Apple Computer, Inc. Product and pricing subject to change without notice. 
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FREE INSTALLER: 


To: Mac Developers & Product Managers 





From: MindVision (Creators of Stacker for Macintosh) 
Subject: Free Copy of DEVELOPER VISE 3.0 


Message: We've got a great new installer for you. 
Here’s your chance fo try it for free. 
No risk, no obligation, no hassle. 
Call today, don’t delay! 





Your product.vct 
















Original Compressed Percent Date 
Size Size Smaller Modified 
vw © Developer VISE Folder 925,975 617,410 
(9 Samples folder 152,069 65,888 57% 3/15/94 
(0 Application VISE 2.1 DEMO folder 38,748 28,796 26% 3/3/94 
D) Read Me 10,712 4.316 60% 
<% Your PowerPC application 
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demonstrate applications and solutions, as well as custom 
solutions implemented with Apple Guide files that tie several 
applications together, and many more. 

Each of these different types of guide files is constructed in 
the same way and from the same elements. Their differences lie 
in the information that they present, and the ways in which 
people use them. 


OPPORTUNITIES WITH APPLE GUIDE 

Since Apple Guide is so much more than just help, the 
opportunities for developers that it provides are wide-ranging. 
The most obvious opportunity, of course, is for an application 
developer to incorporate Apple Guide into the software in 
order to provide a superior user experience and possibly to 
reduce support costs in terms both of documentation that 
needs to be printed and technical support calls that need to be 
answered. The vast majority of technical support calls are 
unnecessary in the sense that someone who had read the 
(mountains of poorly-organized) documentation would know 
the answer. 

But the opportunities don’t end there, by any means. Since 
Apple Guide does not require any modifications to an 
application, a third-party developer can add an Apple Guide file 
to an application either to provide assistance that the original 
developer did not provide or to provide assistance that is specific 
to a vertical market or an individual user. As an example, 
WordPerfect ships with Apple Guide assistance. An opportunity 
exists for a third-party developer to ship an Apple Guide file that 
specifically shows how to use WordPerfect to produce 
documents in a law office. A further opportunity exists for a 
consultant or solution provider to develop an Apple Guide file 
that codifies the policies and practices in the XYZ Law Office. 

Apple Guide can be added to a specific application — or to 
a solution which encompasses several applications. Often in 
designing a custom solution the consultant hesitates to 
incorporate too many different applications since the user will 
need to switch among them. With Apple Guide coaching users 
through each step they need to take in all of the applications 
that make up the solution, a common interface can be provided. 
(Yes, yes, with OpenDoc the travails of combining several 
applications into a custom solution will be minimized. How 
reassuring it is to note that in the latest developer release of 
OpenDoc, Apple Guide is right up there in the Human Interface 
documentation. You can attach Apple Guide assistance to 
OpenDoc parts as well as to traditional applications.) 

And you can also attach Apple Guide assistance to content. 
It is as easy to write an Apple Guide file for a specific 
HyperCard stack as it is to write a guide file for the HyperCard 
application itself. Apple Guide files can be attached to 
databases and interactive multimedia content, too. 

Of course, Apple has provided Apple Guide assistance for 
the Macintosh itself, so there’s no opportunity for a third-party 
developer to add Apple Guide assistance to the Mac OS itself. 

Hah! 





18 APPLE GUIDE ISN’T HELP 





Get yourself over to your local Apple independent dealer 
(not a chain). Have a chat about how they compete with the 
big guys. You'll hear things like individualized service, custom 
solutions, on-site repairs, etc. You may well hear that your local 
independent dealer bench tests most if not all of the machines 
that are sold. Many times memory and disk configurations are 
modified before the customer takes the computer. If that dealer 
had an Apple Guide file that could be tossed into the 
Extensions folder and automatically added to the Guide menu, 
the dealer’s added value would be visible to the user whenever 
necessary. What would such a guide file contain? Phone 
numbers, hours of the service department’s operation, 
information about service contracts, etc. The nice thing about 
Apple Guide is that it is unobtrusive, there but not active unless 
you want to use it. If the dealer shipped computers with a 
screen saver that displayed promotional information, customers 
would probably shop elsewhere. On the other hand, an Apple 
Guide guide file that’s only there when the user asks to see it, 
is a true service to the user and a benefit to the dealer. 


CONCLUSION 

Apple Guide can truly be the gateway to a much simpler and 
more sophisticated user experience. Since applications don’t 
need to be modified to incorporate Apple Guide, you can do 
quite remarkable things without jeopardizing the way things 
work. With scriptable applications, you can incorporate 
AppleScript into your guide files and provide an integrated 
solution that performs many tasks for the user. When you do 
have the opportunity to make minor modifications to 
applications, you can provide a vast range of Apple Guide 
features. Even with an unscriptable and unmodified application, 
however, you can provide a range of assistance that will make 
your users very happy. 

In a way, its a good thing that Apple Guide is so new. 
Many people have never seen it at all, and a goodly number 
have only read about it and seen screenshots. As an experiment, 
find someone who has never seen Apple Guide in action, and 
have them watch while you demo some simple part of the 
Macintosh Guide. The first time a coach mark is drawn, don’t 
watch the screen: watch the person’s face. They will smile. 

Since 1984, our Macintosh computers have smiled at us. 
It’s time to return the favor. 


For More INFO 

Jesse’s book, Real World Apple Guide, due out in April from 
MET Books, has 400 pages and a CD-ROM to help you develop 
Apple Guide assistance. $39.95 at bookstores — ISBN 1-55851- 
429-5 if they have to order it— or you can call 1-800-488-5233 
to order direct. 

Additional docs are on Apple’s Mac OS SDK, including two 
articles, one from develop 18, and one from MacHack. 
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Let's Table the discussion. 





ake data from multiple sources and create 

an unlimited number of rows and columns 
made up of text, movies, pictures, ICONS, 
SICNs and other types of information. 


ppleScript support provides integratation 
with other applications. Full set of object 
resolvers provided. 


B uild powerful tables in your C/C++ 
environments by replacing the list man- 
ager with Tablelt!. Our drawing procedures 
make LDEF's a thing of the past in under 5 
minutes. 


eap into the future with support for 

OpenDoc™, the exciting new compound 
document architecture. Combine Tablelt! parts 
with other commercial and custom parts to 
provide exciting and powerful solutions. 


nlarge the amount of data you can work 

with in your application by combining 
TablelIt! with NeoAcess™ - the powerful 
cross-platform object-database. No more RAM 
limits! 


| jose Tablelt! with your current applica 
tion environments - 68K and PowerPC 
versions are available for 4D, HyperCard, 
SuperCard as well as most C/C++ compilers. 
Certified PowerPC native for CodeWarrior. 


y ‘est drive a version on a 30 money back 
guarantee. 
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Tablelt! Features: 


¢ Unlimited number of rows and columns - go 
past the typical 32K limitation! 

¢ Support for core, database, table and text 
suites. Playable, Recordable and Attachable. 

¢ Over 100 properties that provide customized 
look and feel. 

¢ Drag and Drop Support. 

¢ In-cell editing 

¢ DR/2 for OpenDoc available now! 


Pricing: 
$150 retail for stand-alone, HyperCard, 


SuperCard or 4D. Developers Licenses and 
OpenDoc part licenses available. No Royalties! 


Graphical Business Interfaces, Inc. 
Voice: 219-253-8623 Fax: 219-253-7158 
E-Mail: into@gbi.com 
hitp://www.gbi.com 
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The Debugger V2 
& MacNosy 


by Steve Jasik. 


Information 


he Debugger is a low and high-level 

symbolic Debugger that runs in a full multi- 

window Macintosh environment. You can trace 
program execution, view the values of variables, etc. of 
both 68K and PowerPC programs. 

MacNosy is a global interactive disassembler that 
enables one to recover the source code of any Mac 
application, resource file or the ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.0x or System 7.x) 
environment symbolically! 

It is the only debugger to use the MMU to protect your 
CODE resources and the rest of the system from the 
program you are debugging. With MMU Protection you can 
find errors when they happen, not millions of instructions 
later! (Macintoshs with 68030 CPUs only). 

The Debugger is the debugger of choice at: Adobe, 
Aldus, Claris, Electronic Arts, Kodak, Metrowerks, etc. 
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An example of a structured data display window 


Control 


Its Features Include: 


® Symbolic Debugging of any Macintosh program, ROM, or 
code resource (DRVRs, XCMDs, INITs, PDEFs, 4DEXs ..) 


® Source level debugging for Metrowerks & MPW compiled 
programs (C++, C, Pascal, Fortran, ...), and an Incremental 
Build System with instant Link for superfast development. 


® Object Inspector for MacApp 3 programs 
® Source level debugging of Think C™ projects 


® Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 


® Simultaneous Symbolic debugging of multiple “tasks” 


© Fast Software Watchpoint command to find clobbered 
variables 


® Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and Heap Check to detect program errors before 
they become disasters 


® Structured display of data (hypertext) with user 
definable structures while debugging 


® Conditional breakpoints to help filter out redundant 
information 


® Continuous Animated Step Mode to watch your 
program execute instruction by instruction 


® Detailed symbolic disassembly for both 680x0 and 
PowerPC with symbol names, labels, cross ref maps, - 
make it possible to ferret out the secrets of the ROM, etc. 


® "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 


The Debugger V2 & MacNosy: $350 


Runs on all Macs. Call For Group prices or Updates. 
Visa/MC Accepted. 


Available from: Jasik, APDA, Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs ¢ 343 Trenton Way, Menlo Park, California 94025 « (415) 322-1386 


Internet: macnosy@netcom.com «¢ Applelink: D1037 
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By Brian Sutter, MindVision Software 


Dynamic Localization 


Prepare your software 
for going global 


Recently. while working on our installer 
program, one of our developers needed 
a feature to dynamically localize the 
installer to the language in use on the 
destination computer. That is, when the 
installer runs, make sure it uses the 
language that the user expects to see. 
After throwing around ideas for a couple 
of days, we agreed on a way to do it 
(sometimes you just have to let the boss 
win the arguments just so you don’t ruin 
your chance of getting a pay raise). 


BREAKING THINGS DOWN 

While thinking about how to do dynamic 
localization, it occurred to us there are 
two groups of resources that our 
application needs to use. One group of 
resources don’t need to be localized. For 
example, CODE, ICN#, CURS, LDEF, etc. 
These are the resources users will never 
see, or are the same in every language. 
The other group of resources need to be 
localized for different languages. For 
example, STR#¥, DITL, STR , vers, etc... 
These are resources the user may read at 
one time or another. 

Now, when we build an installation 
kit, we typically put everything into a 
single file which we call an installer. A 






Install | 
| Installieren__ | 
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good part of the challenge we faced was how to keep 
everything in a single file while still allowing ourselves to keep 
all the localizing material in resources like everyone is used to. 
In this article, I'll go through the specifics of how we dealt with 
this challenge in our application, and provide code samples you 
might find useful for doing similar things. 

We broke our installer down into two parts. The first part we 
call the “Base Installer’, which includes the resources that don’t 
need to be localized. The second part includes resources that need 
to be localized for each language the installer needs to support. 
For example, we need different DITL and STR# resources for each 
different language we want to support. For these resources we 
have files called, “English Installer” , “French Installer’, “German 
Installer”, etc. We call these our “Language Resource Files”, 

We have all these different files of resources, and we want 
to combine them all into a single file (so users see only one file, 
not a bunch of files). For example, we have STR# with ID of 
1000 for English, French, German, Italian, etc. How can our 
installer have resources with these same types and IDs in it? The 
answer is, don’t. When we assemble our application, we open 
each language resource file for block reading, and read the 
entire resource fork into a handle. We write the handle into our 
own resource type of ‘Lirs’, and give it an ID based on the 
language. Here’s how we did it. 


OSErr ResFile2Resource(Str32 *fileName, short vRefNum, 
long dirID, short languagelID) ; 


OSErr err: 
short refNum; 
long eof; 


Handle tHandle; 


// Open the resource fork of the file for BLOCK reads 
if (err = HOpenRF(vRefNum,dirID, fileName, fsRdPerm, &refNum) ) 
goto exit: 


// Get the size of the resource fork 
if (err = GetEOF(refNum, &eof)) goto exitErr; 


// Create a handle to hold the entire resource fork 
tHandle = NewHandle(eof); 
if (err = MemError()) goto exitErr; 


Brian Sutter — Having developed and delivered numerous versions of Developer VISE, MindVision’s installer product, Brian 
has turned his attention to matters of greater import. As one of Lincoln, Nebraska’s foremost Marathon specialists, he eagerly 
awaits an Internet-playable version of Marathon to further test and develop his playing skills. 
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When it comes to performance dtF is in a class all its own. dtF utilizes a proprietary query 
optimization and caching scheme to obtain unparalleled performance. And if you are in need 
of a quantum leap in performance, use the dtF native PowerPC standalone or server version. 


Full transaction control and error recovery guarantee maximum data protection even after 
sudden system crashes. dtF databases are compressed and encrypted to protect against all 
unauthorized access, even disk editors. 


Integrated data dictionary, security, automatic index selection, query optimization, deadlock 
detection and error recovery allow you to concentrate on your application. The dtF API 
was designed for a seamless integration with third-party toolkits and class libraries. 


dtF features include SQL, BLOB support, electronic documentation, sample applications, 
tutorials, and tools for importing, exporting, creating, managing databases and users. dtF is 
currently available for Macintosh, DOS, Windows, OS/2. The C/C++ API is identical 
across all platforms. 





Available for Macintosh System 7.x and native PowerPC. MPW C/C++ (68K and native PPC), 
Symantec C/C++, Metrowerks CodeWarrior (68K and native PPC). Separate versions for use with 
HyperCard, SuperCard, SmalltalkAgents® and Prograph CPX available. 


Standalone applications built with dtF are royalty-free. 
dtF Americas, Inc. 1 
19672 Stevens Creek Blvd., Phone: (800) DTF-1790 w. dtk Near tne a 


Suite 128 Fax: (408) 996-9534 
Cupertino, CA 95014, USA AppleLink: DTK AMERICA 
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Computer Aided Software Engineering For The Macintosh 
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order | ine_number 
order | ine_quanti ty 
product 

product_description 
product_name 
produc t_num 
product _pri 


@CHARACTER4 Tet | Wesss eta daccsancasodtocesncnectsenentuarassanncosnooee 
®DECIMALS.2 #client number oe 

; produc t_name 
— a bripen coated product—_description 


produc t_pr ice 
nF 












pr form 


ber INTEGER NOT NULL, 




























INTEGER NOT NULL, 
order formwnumber >, 
client number > REFERENCES client 





*order | ine_number 
order | ine_quanti ty 
®order form_number 
®product_number 













order form_date 
order form_total 
Pel ient_number 





Data modeling and SQL generation for Information Engineering, Chen... 
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» See memory allocation in any open heap at a glance. 

= Easily spot memory leaks. 

» Flags heap corruption when it happens. 

Works with source level debugger to let you find memory problems fast. 
i Stress applications on the fly with Purge, Compact, and Zap. 








ime Allocate memory at will for precise stress testing. 
i» Log heap data - easily document heap status over time. 


i NO need for source code: nothing inserted in code; no patches 
to the system. 


im Works with 24-bit, 32-bit, and modern memory managers. 
For Macintoshes with 68020 or better. Requires System 7.0 or later. 


only $99 US 
Order now Peas Adianta, Inc. 
Phone: (408)354-9569 « FAX: (408)354-4292 


AppleLink:ADIANTA ¢ AOL:Adianta ¢ Internet:adianta @ aol.com 


For VISA, MC, or American Express orders by mail, fax, or Applelink, please include 
name, address, card number, expiration date, and phone number or email address. 


Also available through the MacTech Mail Order Store. 
for more information contact 
dianta, Inc. ¢ 2N. Santa Cruz Ave. #201 ¢ Los Gatos, CA 95030 











Power MacForth 


The Language of Innovation is now 
available native on the Power Macintosh. 


FEATURES 

@ Royalty Free Turnkey 
Compiler 

@ Text Editor 

@ Online Glossary Tool 

m@ System 7 Compatibility 

= 68020 Assembler 

™ 68881/2 Co-processor 
support 


@ High Level Graphics 

@ Toolbox Support 

@ Extensive Documentation 
™ Reasonable Upgrades 

@ Optional Tools Disks 

= MacForth Plus $199 

™ Power MacForth $199 


Creative Solutiow, Ime. 


4701 Randolph Road, Suite 12 
Rockville, MD 20852 
301-984-0262 or 1-800-FORTH-OK (orders) 
Fax: 301-770-1675 Applelink: CSI 
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// Read the entire resource fork into our handle 
if (err = FSRead(refNum, &eof, *tHandle)) goto exitErr; 


// The current resource file is our installer application 
// Add this entire resource fork to our installer application 
AddResource(tHandle,'Lirs',languageID,"\p"); 


if (err = Resbrror 0) goto exitErr; 
WriteResource(tHandle) 
err = ResError() 


// Release memory occupied by this resource 
ReleaseResource(tHandle) ; 
tHandle = nil; 


exitErr: 
FSClose(refNum) ; 
if (tHandle) DisposeHandle(tHandle) ; 


Oxi: 
return err; 


We call ResFile2Resource for every file containing localized 

resources. 

e filename is the name of the resource file on hard drive. 

e vRefNum is the volume reference number where the file 
resides. 

e dirID is the directory id on the specified volume where the 
file resides. 

e languagelID is the resource ID of the language file. We use 
the same defines as Apple’s Languages.h file for the resource 
IDs for different languages, but we add 1000 to those 
numbers because Apple says don’t use resource ID’s less 
than 128. So for the English resources the ID = 1000, French 
= 1001, German = 1002, etc. 


Once we've called ResFile2Resource for each file of localized 
resources, each is a resource in our installer application. 

We've got an additional twist for our application. An 
installer may need to create a number of files. Each of these 
files may need a localized name. The next thing we do is add 
lists of localized file names (supplied by the developer) to be 
installed, one for each language. We use the same ID scheme as 
the above language resources, but use the ‘Flnm’ (filename) 
resource type. The developer stores these in another resource 
file. When the installer is built, we merge these ‘Flnm’ resources 
into the installer application. 

After these language and filename resources are added to 
the installer, we add the rest of the stuff our application needs 
to carry around (all the stuff that’s going to get installed). 


LANGUAGE MAGIC 
When our application is launched, we do a little magic to find 
out what language is being used on the user’s Mac. 


// Assume English in case something fails 
glanguageCode = 0; 


// The following chunk of code was graciously provided to me by a engineer at 
// Adobe Systems, THANKS! 

// Make sure Script Manager calls are available 

if (TrapAvailable(_ScriptUtil)) { 
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Cross-Platform Object 
Database Engine 


Full Featured 


NeoAccess™ allows you to embed the power of a full-featured object-oriented database engine into your 
Macintosh, Windows and DOS based applications. No other object database engine can match NeoAccess's 
impressive feature set, including: Blobs, part lists, iterators, swizzlers, temporary objects, multiple indices on a class, 
schema evolution, a powerful relational query mechanism, a streams-based i/o model and incredible performance. 


High Performance 


Internally, NeoAccess uses extended binary trees and binary search 
algorithms to achieve optimally short access times. Its automatic 
query optimizer ensures that queries always use the fastest access 
path to objects. And indices are dynamically combined, collapsed 
and compressed to keep access times to an absolute minimum as 
the contents of a database changes. NeoAccess’s object caching 
boosts performance by keeping objects in memory even after being 
disposed of by the application. Your applications memory size is 
reduced because only those objects of immediate interest need to be 
in memory at any one time, not the entire file. 


Full Source Code Objects in Database 


We've taken a frameworks approach toward object persistence and database technology. In much the same way that 
application frameworks are used to construct the front-end of an application, NeoAccess is the framework you use 
to build your application's back-end. As is the case with virtually all object frameworks, the NeoAccess Developer's 
Toolkit comes complete with full source code, for all major application frameworks including Metrowerks' 
PowerPlant, Symantec's THINK Class Library and Apple's MacApp on the Macintosh and Microsoft's 
Foundation Classes, Inmark's zApp and Borland's ObjectWindows in Intel-based environments. It can even be 
used without a framework or in one that you've designed. 


Easy to Use 


The programming interface is designed around the concept of minimum visible complexity. Application-specilic 
objects inherit persistence properties from a NeoAccess base class. These objects are organized in the database 
primarily by class. But NeoAccess also knows how classes are related. So multiple classes can be searched in a single 
operation. And of course objects of any particular class can be organized using multiple indices. NeoAccess is 
unique in that it allows objects to be located based on abstract selection criteria or based on their relationship to 
other objects. There’ literally no database administation to deal with — NeoAccess takes care of all the details. 
NeoAccess also includes a Blob mechanism which allows free-form variable-length data to be stored in databases 
with the same ease as fixed-length objects. NeoAccess even includes a powerful set of keyed iterators for traversing 
indices and part lists. Keyed iterators have the unique ability to iterate over only those objects in a set that match a 
given selection criteria. Your users will appreciate NeoAccess because databases are completely self-contained in a 
single document file. So users can treat a database file as they would any other document. 


Proven 


NeoAccess has been commercially available since May of 1992. Hundreds of commercial and in-house applications 
based on NeoAccess technology have already been deployed. NeoAccess can help your organization deliver powerful 
products in a more timely fashign than you ever imagined possible. 


Affordable 


NeoAccess's best feature is its price. The NeoAccess Developer's Toolkit sells for just $749 per developer with 
absolutely no runtime licensing fees. It includes full source code, numerous sample applications, 450+ pages of 
documentation, and 30 days of technical support. So what are you waiting for? 
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Online & CD-ROM Publishers: 


BroadCast 


Electronic Distribution That Works! 


Expand your market beyond the confines of traditional 
distribution methods and channels. Now you can offer your 
customers software on demand, with BroadCast™. 










Sell Your Software Online 


Convert your online presence from a support/marketing cost 
center to a profitable distribution channel. Perhaps you already 
post “crippled” demos online, but have no means of follow- 
through, since the demos are downloaded anonymously. You 
can hope that subscribers are favorably impressed; hope that 

they elect to purchase live software at some future date; and 
hope they complete and mail registration cards. 














BroadCast taps the enormous potential of online services as a 
sales medium, enabling you to convert passing interest into 
direct sales, by offering your products to subscribers at the 
precise moment when their motivation is at its peak. 


Sell Your Software on CD-ROM 


CD-ROM is an attractive storage medium. BroadCast 
transforms it into your most profitable sales medium. With 
BroadCast, you can publish your entire software line, with 
demos of each product, on a single CD. When a customer 
purchases one of your products, he or she is also exposed to 
your other products, and can unlock them, on demand, with 
a single telephone call. 





















BroadCast is easy to implement In seconds, BroadCast will | 
securely compress and encrypt your product, and embed it in | 
an unlocker application that can be publicly distributed. To | 
buy your product, a customer simply runs the unlocker. A | 
unique control number is displayed, together with instructions 
and the telephone number of your sales desk. Your sales 
representative processes a credit card transaction and captures 
registration information. Using software we provide, the sales 
representative then generates a unique unlocking password 
for the customer. When the customer enters that password, 
the product is unlocked. 













BroadCast is secure Our patent-pending technique takes a 
“thumbprint” of the user’s system, and always requires a 
unique password. 







BroadCast is inexpensive Why give up 50 points or more (plus 
co-op) to a reseller, when you can sell direct at a fraction of the 
cost! No receivables, no cost of goods, no freight. Since 
customers try before they buy, you'll likely have no returns, 
either! 
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// Get the ID of the current system font and use it to find out 
// the script code 
scriptCode = Font2Script (GetSysFont()); 


// use the script code to find out the language code for that script 
gLanguageCode = GetScript(scriptCode,smScriptLang) ; 


// “GetScript(scriptCode, smScriptLang)” doesn’t return the 

// correct language code on KanjiTalk 6.0.7, if it returns zero and if 
// the current script is not Roman, we directly get the language code 
// from the itlb resource. 

if (gLanguageCode == 0 && scriptCode != 0) { 


dle = = GetResource('itlb', scriptCode)) { 
geCode = (*(ItlbRecord **)tHandle) ->itlbLang; 


Ss Cris 


// Add 1000 to get the resource ID of localized resources 
gLanguageCode t= 1000; 


At this point in the process, the current resource file is our installer 
application, and it contains all the localized resources and filenames 
the installer needs to localize itself for the current language. 


LOCALIZING FILE NAMES 

Now that we know which language resource ID to search for 
(gLanguageCode), we'll call GetlResource to find any localized 
filenames to install. If it's found, we copy the localized names 
to the list of file names to install. If not, we'll just leave the file 
names alone. 
// See if there are any localized filenames 
tFilesHdl = GetlResource('Flnm', gLanguageCode) ; 
if (tFilesHdl) | 

.. Our installer contains a handle of filenames, so we need to call a routine to 


.. replace the original names with these localized filenames. 
ReleaseResource(tFllesHd1) ; 


LOCALIZING INSTALLER RESOURCES 


Now that we have localized file names, let’s see if there are 
localized resources for the installer. Remember that these resources 
contain entire resource forks of the localized language files. 


// See if there are any localized resources. 

tHandle = GetlResource('Lirs',gLanua 

if (tHandle) { 
DetachResource(tHandle) ; 


// Store the size of the resource 
count = GetHandleSize(tHandle); 


// Call routine to find a volume that is large enough to create a file the 
// size of the resource. 
vRefNum = FindValidVolume(count) ; 


if (vRefNum) { 
// Come up with a unique filename 
NumToString(TickCount(),tFileName) ; 


// Create file to the root directory (dirID = 2) 
err = HCreateResFile(vRefNum, 2 
if (err) goto doDispose; 


tFileName): 


// Open the Resource fork for block writing 
err = HOpenRF(vRefNum, 2, tFileName, &refNum) ; 
if (err) goto doDispose; 
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// Write out resource to create the file’s resource fork 
err = FSWrite(refNum, &count, *tHandle):; 


FSClose(refNum) ; 
if (err) goto doDispose; 


// Open the resource file we just created 
gExtraResRefNum = HOpenResFile(vRefNum, 2, tFileName, 
fsRdPerm) ; 


doDispose: 
DisposeHandle(tHandle) ; 


\ 
J 


If we successfully create and open this resource file, it will be 
the current resource file, and it will be searched first for dialogs, 
strings, and other resources. If the Resource Manager isn’t able 
to find it there, it will automatically search in the installer 
application’s resources to find what it needs. 

One thing not discussed here is how to make the temporary 
resource file invisible. It’s a good thing to do so the user won't 
see a weird file name appear on their volume while the install is 
taking place. 


RESNOTFOUND (OxFF40) 

What happens when the language in use on the destination 
computer isn’t supported by the installer? The installer could 
bring up a dialog alerting the user to this fact, and allow them 
to choose the language to install, but what language do you use 
for this dialog? We chose to sidestep the problem by running 
with a default language if the system language is not supported 
by the installer. 


CLEAN Up AFTER YOURSELF 
Before quitting our application, we need to clean up a little bit. 
We need to close and delete the file of localized resources. 
// Cleanup 
if (gExtraResRefNum != -1) { 


// Since we don’t store this filename anywhere, we call PBGetFCBInfo to get it 
FCBPBRec pb; 


OSErr err; 

otroZ Locrs 

pb.10FGEinds = 0; // We're not indexing 

pb.ioVRefNum = 0; // 0 = All open files 

pb.ioRefNum = gExtraResRefNum; //Refnum of our resource file 
pb.ioNamePtr = tStr; // Storage place for the name 

err = PBGetFCBInfo(&pb, false); 

if (!err) { 





// Close the Resource File before trying to delete it 
CloseResFile(gExtraResRefNum) ; 


// Delete the Resource File now that we have the vRefNum, directory ID, 
// and the Filename 
err = HDelete(pb.ioFCBVRefNum, pb.ioFCBParID, tStr); 
} 


OTHER LOCALIZATION TIPS 


Other localization items to keep in mind when writing your 

application: 

e Double byte languages. Make sure any strings you allocate 
in your applications are long enough to support double byte 
languages. 
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NEW! Version 2.0 - Supports PPC & Fat Binary 





PatchWorks 


Builds Updaters Without Programming 





PatchWorks has many options, but only one function: 
to create updater applications for distribution via public 
channels (e.g., online services). 


Before the advent of PatchWorks, creating an updater 
was a project in itself, one that consumed valuable 
programmer time which could more profitably be spent 
on revenue-producing projects. 


With PatchWorks, you create an updater in minutes. 
Since there’s no coding or scripting, no bugs are 
introduced. Just fill in a dialog, and PatchWorks does the 
rest! 


Distribute updaters frequently to reflect maintenance 
releases, and watch your tech support and fulfillment 
costs fall dramatically. 


Most important, your customers will know you care. 


SSS patchiorks* SS 
OffLine™ 3.0.5 (APPL, OFFL) 
OffLine™ 4.0 (APPL, OFFL) 

OffLine Updater 

PW Log - Offline™ 4.0 


: i t 
Panlovessiun @ Rewrite updater 


© Merge resources into updater 
Name 


Type 
Creator 


Old File 


Screen Name |Specify => 


k 
Name Specify => v [offing 
New File { 


Mod Date Date patched v [Cksums... |} (Copy all 


Features 


¢ Works with apps, INITs, cdevs, fonts, drivers, etc. 
¢ Now supports PPC, fat binary, & 4D apps 
¢ Customizable user interface 


¢ Updaters support multiple old versions 

¢ Resource compression (diffing) produces small updaters 
¢ Preserves personalization data (name, serial #, etc.) 

¢ Updater distribution is unrestricted & royalty-free 


Pricing: Begins at $195. Call for more information. 


SNA, Inc. 

2200 NW Corporate Blvd. 

Boca Raton, FL 33431 

Tel (407) 241-0308 ¢ FAX (407) 241-3195 
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The database engine for professionals 


_CXBase Pro 


Based on the database engine used by Apple AOS for their 
eWorld content publishing software, CXBase Pro represents the 


State of the art in data storage and retrieval technology. CXBase Pro 


has all the tools you need to develop any kind of application that 
needs its own database engine. 


The philosophy behind CXBase Pro is to provide a simple, 


consistent, and powerful API that lets you work in whatever way you 


choose. CXBase Pro is delivered with full source code, giving you 
maximum flexibility and security. The CXBase Pro library provides 
both multi-keyed data record handling, and flexible BLOB storage 
where you define the data format. And CXBase Pro has been 
engineered from the ground up for maximum performance. 


§ Powerful and flexible select module 
CXBase Pro lets you create multiple kinds of selections, and 
provides a callback mechanism that allows you to both display 
the progress, and capture the data as it is selected. 

i Native PowerPC version 
What better way to use the speed of a Power Macintosh than 
to rev up your data access? Average native speed 3 times that 
of the fastest Quadra. 

#100% Cross-platform 
Both the source and data files are compatible across all 
platforms. Yes, Virginia, it really works! 

H Access to logical and absolute record numbers 
You can access data records not only by key, but also by logical 
and absolute record numbers. 

H Royalty-free license 
You pay once for the development license. Period! 


Test drive before you buy - Full-featured $49 demo available! 


CXBase Pro also comes in a demo version. You get the complete manual, and a full-featured library limited only by file size. You get access 
to all the function calls, and you can use it as long as you like. If you decide to buy the full package you get credit for the price of the demo. 


For full prices, to order, or to receive more information, contact: 


TSE International | Taandwarsstr.51 | 1013 BV Amsterdam, Holland ' tel: 31 20638-6507 | fax: 31 20620-4933 | AppleLink ; TSE.INT 


Apple, AOS, eWorld, Power Macintosh, and Quadra are trademarks of Apple Computer, Inc. 


e Make sure all strings are in resources. Don’t hard code any text 
within your application. This will save you from having to 
recompile multiple versions of your application, one for each 
language. It’s a lot easier to add different resources to one set 
of compiled code than it is to maintain multiple sources. 

e Don't split your strings up and recombine them later. You 
might be surprised by what happens when different language 
grammar rules are applied. 

e Really, don’t embed any strings, not even single character 
strings like quotes. Some languages use multiple characters for 
quotation, so patching the application gets terribly unpleasant. 

e Don't specify a font by name when you really mean system 
font or application font. 


TIPPING Is NoT A CiTy IN CHINA 

Another tip for copying the resource fork of a file: use block 
read and write operations, don’t use the resource manager. You 
might be surprised how many programs copy or build 
applications by copying a resource at a time. This is way too 
slow! Even if you don’t need all of the resources, in most cases 
its better to copy the entire resource fork using block reads 
and writes and then delete the resources which aren’t needed. 


// Copying the Resource Fork from one file to another... 
HOpenRF (sourceFile.. &sourceRefNum) ; 
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HOpenRF (destFile.. &destRefNum) ; 

GetEOF (sourceRefNum, &sourceSize) ; 

CopyBytes (sourceRefNum, destRefNum, sourceSize) ; 
FSClose(sourceRefNum) ; 

FSClose(destRefNum) ; 


// If you need to, then delete some resources... 
SetResLoad(false) ; 

destRefNum = HOpenResFile(destFile...) ; 
GetlResource(); 

RmveResource(); 
CloseResFile(destRefNum) ; 

SetResLoad (true) ; 


Notice the SetResLoad(false). You don’t have to load in an 
entire resource to be able to delete it. Also, call 
SetResLoad(false) before opening the resource file to 
prevent “preload” resources from loading. It saves time and 
space. Just be sure to set it back to true when you're done. 


Fite Tuts Tre Away 
For examples on how to do just about any file operation, look 
for “MoreFiles” on the Developer CDs from Apple /one random 
place on the Internet that we found it was at: 
ftp://src.doc.ic.ac.uk/computing/systems/mac/Mac-Technical/sc/morefiles, 
and there’s always Apple’s site: 
ftp://ftp.info.apple.com/Apple.Support.Area/Developer_Services — ed stb]. 


MACTECHMAGAZINE @® MarcH 1995 


PICTURE IF You WILL... 


Now it’s time to give you a visual example of the difference 
you might see. Here’s an example of an installer as presented 
in English. 





Segment.1 


Install your favorite application and have your installer 
‘dynamically localize to the System being used. 


ct) 
[ Switch Disk | [Install | 


be 


on the disk “1” 





English System 
Here’s the installer localized to German and Kanji. I don’t speak 
German or Japanese, so I wasn't able to localize the “Install your 


favorite...” text in the window. I just changed the text to show 
you that it does show different text for German and Kanji systems. 


Segment.1 


Einfache Installation + 


Install your favorite German application and have your installer 
‘dynamically localize German. 


| Beenden 
__ Volume} ff installieren 


“0 


auf der VWolurnie "1" 


fi saa 4v3b-I oo 








Kanji System 


Here’s a screen dump of our app in ResEdit. It contains all the 
normal resources as well as our two special resources: 

‘Flnm’ — Resource containing the localized file names for 
German and Kanji. 
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Industrial Strength 


* File Edit Search Windows Fonts Eval 


> Output Window 


Write industrial strength business applications for the 
Macintosh, without having to learn all about the 
Macintosh ToolBox. Applications which are intelligent 
and powertul, and yet simple to maintain. 


And with MacProlog32, write them the easy way: 


High level dialogs, menus, graphics and windows 
Robust and efficient run time system 

Apple Events and C/Fascal code interface 
Expert system, OOPS and database options 


Not to mention the integrated source level debugger, 
multi file program editor, work files, incremental and 
optimising compilers, and full Prolog predicate library. 


(Fa The industrial strength business 
-_ Prolog32 applications development kit! 


Logic Programming Associates Ltd 
Phone (US Toll Free): 1-800-949-7567 


Phone: +44 81 871 2016 - Fax: +44 81 874 0449 
Email: lpa@cix.compulink.co.uk - Applelink: UKOO49 





‘Lirs’ — Resource containing the localized resources for the 
dialogs, strings, etc. for German and Kanji. 

There is also a TEXT resource containing the text to 
appear in the installer window —- one for each language 
(English, German, and Kanji.) 

Notice there isn’t a separate English resource for ‘Flmn’ 
and ‘Lirs’. This is because English is the default language and 
those resources are represented by the normal DLOG, STR#, 
MENU resources in the Segment.1 file. 





Segment.1 





Finms from Segment.1 


































re Name 
t= Bee ta ? 1 aYoke: 1 1 4 oR r 7) 
th CHP IL, O03 : berman 
E) RTS RTE iv ® : ag P tp Sdn 
1013 114 Kanji 
BNDL CDEF CODE CURS DATA detb ; : 
Lirss from Segment.1 
ead 1 He bene vu ! & = " ID Size Ne 
A Ok EE ee 
ee | &.. 19873 “German” 
DITL DLOG DREL Finen FREF icl8 1013 168604 “Kanji” 
1 


“English” 
1003 93 0“ Gerrman” 
1013 100 a) riji ‘i 











—_ OlOltial rac 

Oo sii Ey ye 0 

SB ee aloo e000 Eee le (E) Sy 
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ICN* ICON Lirs MENU PICT SIC 






ee oer tial oler tial 
OO1G LOOT OO1O Lont 
oe a 6 

ee BOOT TTS 
te brown loo ao00 






VISS zERO 


Well, now you’ve seen how we go about adapting to the 
current situation. I hope this gives you some ideas about how 
you might pack more punch into your software. 
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Databases in the Finder’? 





Unfortunately, most users must interact with relational databases at the SQL level or be- 
hind a front-end that can take months to develop. 


select invoice_num,invoice_date,cust_id,cust_name from invoices,customers where invoice_id = 112;printall; 


Why not view and edit your data at the Finder level? Announcing Cataloger™’. 





ataloger brings a whole new way of working with databases to the Macintosh. 


The Finder™ has always provided a view of our desktop files, why not database 
records too? 






























Eq 9 4 items 


ET] Name Kind 


I-OO00000 FS 


— —= = 


I-OOO0000 ¥e 


I-OO00000T 


— ey 


-OO0000 Fs 


l-O00000s0 


Apple's Open Collaborative Environment places a catalog icon at the Finder. 
Open the icon up and you'll see a window like the one above. The AppleTalk 

catalog shows nodes on the network. The PowerCat catalog shows users and 
groups in a PowerShare Server. 





The Contact and Invoices catalogs (for example) can show information from 4D fe 
Server, DAL/DAM , Oracle and Sybase databases! If your needs are more custom- | 
ized, you can write AppleScript handlers to provide the contents of your catalog. 


The Catalog Manager (an AOCE AP')) allows for Catalog Service Access Modules 
(CSAMs) to be created that interact with external sources. 


The Finder and other applications make requests through the Catalog Manager and 
Cataloger does the rest. There are no limits to the amount of data brought back. 





Templates provide the ability to view and edit individual records. AOCE Templates 
are designed with Template Constructor™. This powerful application 

let's you easily design forms to view data coming from several sources, control 
behavior with C and AppleScript, and view row/column data with Tablelt!™ - a 
powerful data display tool. 





Invoice *- 


Company - imbers iti Terms : Net 30 Days ¥ 


Oty Part * | Description Cost Each | Line Total 
' 2143 0: Propeller : 3 


: Drain Plugs 


1 


—r 


: 32.00 


Prepared boat for summer season. “y| Subtotal: 
Dewinterized , tuned up and replaced main 
propeller. Light assembly replaced after 

testing front lights failed. E 1110.49 


Tax: 





rah Access information and catalog definitions are stored in and protected by the 
ee (2! AOCE Keychain. Your users can have one username and password for a variety 
— of data sources! 


Need more horsepower? Database Scripting Kit™ provides AppleScript access 
to all of the connection information and data sources. Write AppleScript routines 
that send queries and parse results from within your own application. 














Cataloger/Template Constructor includes: How to contact us: 

Database Scripting Kit™ with connectors 
for 4D Server, DAL/DAM, Oracle, Sybase 
and others. 


Graphical Business 


Interfaces, Inc. 
DSK Cataloger™ CSAM 


Template Constructor™ with Tablelt!™ . 
i Voice: 800-424-7714 or 219-253-8623 
Several example catalogs/templates 
and over 100 example AppleScripts. Fax: 219-253-7158 
Complete scriptability, native for Power 
Macintosh. Drag Manager and Thread 
Manager support. 


E-Mail: steve@gbi.com 


GBI. Bringing your data into view.™ 





THINK TOP 10 


By Michael Hopkins and Craig Conner, Symantec Technical Support 


SYMANTEC. 





This monthly column, written 
by Symantec’s Technical 
Support Engineers, aims to 
provide you with technical 
information based on the use 
of Symantec products. 


This month we'll cover the PowerPC and 
Symantec’s C++ Cross Development Kit. 


Q: How do I debug my PowerPC 
application? 


A: The Symantec PowerPC Cross 
Development Kit does not include an 
integrated source-level debugger. You 
have three options for debugging. 


1) The CDK includes Apple’s two 
machine PowerPC debugger which 
allows you to send debugging info 
from the PowerPC running the 
application to a non-PowerPC 
machine connected via the serial 
port. Although this is a very good 
debugging environment, it requires 
an extra machine. 


2) An alternative is to use Apple’s single 
machine debugger, available from 
Apple as a pre-release version. 


3) Perhaps the best alternative is to 
compile your code under the 68K 
compiler and thoroughly debug it using 
the integrated Symantec Debugger. 
Once your program is debugged, you 
should be able to recompile it using the 
PowerPC compiler without modifying 
the runtime behavior. 


Q: I am getting bus errors when I run 


my PowerPC code. How do I find 
dangling pointers in my programs? 


EA THINK Top 10 


A: When you create pointer variables, set them to the value 
(void *)0xDEADBEEF. This is an odd address and you do 
not need to worry about it being a valid address on Macintosh 
NuBus cards (the address lives in slot D’s superslot space). Any 
time you dereference such a pointer before assigning a value to 
it, you will get either a bus error or an address error. This 
technique also works for 68K code. 


Q: How do I make a fat binary application using the CDK? 


A: Build your application with the 68K compiler, and then add 
your resulting application file to your PowerPC project. When 
you build the PowerPC app, the environment will copy the 68K 
resources (including the 68K 'CODE' resources) into the final 
app along with a 'cfrg' resource and the PPC code (in the 
data fork). 


Q: I am in the process of porting some scientific applications 
written in C to the PowerPC. I run into all kinds of problems 
when compiling it with the C++ compiler. Is there a native PPC 
C translator available for the CDK? 


A: Yes, we do have a native C translator available as well as a 
complement of Standard C Libraries. If you would like to receive a 
copy, give us a call at (503) 465-8470, send us a message at d0152 
on AppleLink, or email us at powermac@bedford.symantec.com. 
Be sure to include your name and mailing address with your 
request. Allow 5-10 days for shipping. 


Q: I am trying to compile my PPC project and I get a link error 
"undefined main()". What causes this? 


A: The current version of the THINK Project Manager is not 
capable of hosting a runtime PowerPC environment. You will 
get this error if you choose Run from the Project menu. 
Instead, you should compile the project by choosing Bring Up 
To Date, and then choose Build PowerPC App from the 
AppleScript menu to build your executable. 


Q: I am trying to compile my program using the CDK and the 
PowerPC C compiler and I am getting the warning: "File 
<stdio.h>; Line 28; While compiling 'myfile.c' 
Warning: Warning: The Symantec ANSI libraries 
require mapcr to be turned off". What should I do’ 


A: Go into your standard library folder and rebuild those 
libraries that you are including in your project. The libraries that 
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will most likely need rebuilding are PPCANSI.o and PPC 
CPlusLib.o. 


1) For each library you want to rebuild, find and open the 
corresponding project file (PPC ANSI.o is PPCANSI.7, 
PPG CPlusLib.o is PPCCPlusLib.7 ). 


2) Choose Remove Objects to make sure that all of the source 
files are recompiled. 


3) Go to the compiler settings page for both PowerPC C and 
PowerPC C++ (under Edit, Options, PowerPC C or PowerPC 
C++ ) and uncheck the Map carriage returns check box. 


4) Bring the project up to date. 
5) Use the Build PowerPC Lib script to create the library. 


Q: I just installed the CDK patch version 7.0.4.1 and when | 
rebuild the ANSI libraries, I get errors "Undeclared FATANX, 
FFEXT", and "FX2DEC" in math.c, printf.c, and scanf.c. 
How do I fix this? | 


A: There is an error in the fp.h file from the CDK 7.0.4.1 
patch which causes these problems. This will be fixed in the 
next update. To work around it, do the following: 


e In the Universal Headers folder, rename fp.h _ to 
PowerPCfp.h. 


e Create a new file named fp.h in the Universal Headers 
folder containing the following: 


#tpragma once 
tif defined(powerc) || defined(__powerc) 
#include <PowerPCfp.h> 
else 
#include <SANE.h> 
endif 


Q: I am trying to build PPCTinyEdit.z with the CDK and I 
get an error from ToolServer "PPCBuild.out error 
MarkReleaseObject new failed error -108", 
What is causing this and how can I fix it? 


A: An error code of -108 is a system error that indicates that 
you do not have enough room in your heap zone. Increase 
your memory partition for ToolServer and the problem should 
gO away. 


Special Thanks to Glenn Austin, Mark Baldwin, and Colen 
Garoutte-Carson. 
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Creations al 


CUSTOM SOFTWARE 
DEVelLOrpMENT 


Custom software development at resonable rates. Past products include: 
Questick & Quepad ADB driver and control panel (published by 














MicroQue), Spectre VR (published by Velocity), and PowerFTP (pub- 
lished by Opensoft). We specialize in Macintosh software development 
and home game system software development. 





Do you want to control X=||© devices 
from your Macintosh Application? 


Control X-10 Devices from your Macintosh Applications! Use our library 
and it’s easy! Royalty free distribution! Introductory price is $50. Source 
code available at additional cost. 


Green Mragon Creations, Ine. 
412 Kimmons Avenue, Water Valley, Ms. 38965 
1-601-473-4225 
AppleLink: GREEN.DRAGON 
Internet:howard_shere @ greendragon.com 





yo? ScriptWizard 


ce ..the essential scripting tool 





ScriptWizard™ brings professional script editing, testing and debugging 
facilities to AppleScript™. Improve your scripting productivity with this 


powerful and intuitive tool! 4-1/2 mice - MacUser UK 
4 stars - MacWorld UK 


e Watch Variables 


Variable-watcher shows a 
complete list of variables 
and script properties. 


eFind & Replace An 
irreplaceable tool for 
complex script develop- 
ment and modification. 


e Step-Execution 
Step-execution of scripts 
allows you to step through 
scripts one Apple event at 
a time. 


e Easy Script Navigation 
The "locate" pop-up shows 
all properties and handlers 
defined in your script, and 
instantly jumps to the one 
you choose. 


only 


99 





@ File Edit Find Script Win 




















aod @ 
{ , "4D Prefs", “4... 3 
" jacintosh HD ‘System Folder :Pre. 3 





"Its debugging capabilities are a 'must 
have' for any serious scripter" 
- Dan Shafer: Author, Consultant and Scripting Advocate 


US Offices: 

DD P.O. Box 700237 San Jose, CA 95170-0237 
Phone: (408)253-7199 Fax: (408)252-2378 
European Offices: 


FULL MOON P.O. Box 116 ST ALBANS, Herts, ALI2RL, UK 
SOFTWARE Phone: +44 727 844232 Fax: +44 727 856139 
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By Kurt Schmucker, Apple Computer, Inc. 


Fooling the user gets the 
job undone 


Command objects as implemented in 
most Macintosh frameworks provide an 
excellent way to implement undo for 
most types of user actions in most types 
of applications — most, but not all. 
Typically, the command object 


stores enough information to be able to. 


perform the action, to be able to undo 
the action, and to be able to redo the 
action. In response to a user action, your 
code allocates an appropriate command 
object, initializes that object, and then 
returns that object to the framework. 
The framework will immediately send the 
“Dolt” message to this object to have the 
desired action performed. The 
framework holds onto that command 
object and will automatically send the 
“Undolt” and “Redolt” messages to the 
object if the user chooses the Undo or 
Redo from the Edit menu. The command 
object, using its stored data, will then 
undo or redo the operation. This 
completely relieves the developer from 
the responsibility for the run-time 
handling of the Undo menu item. [1] 

This scheme works as long as there 
is enough memory and speed to undo 
and redo the operation (which is the 
whole point of implementing the 
command object.) Unfortunately, this is 
not always the case. For example, 
consider a structured drawing program 
like MacDraw or Canvas. In such a 
program, the user can select any subset 
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Undo the Impossible in Prograph CPX 


of the objects that have been drawn and bring those selected 
objects “to the front,” that is, re-order them in the z-coordinate. 
It would not be possible to store the old order of the objects, 
in a reasonable amount of memory, in order to be able to 
effect an undo. (Admittedly, the definition of ‘reasonable’ is 
subjective. The straightforward use of command objects for 
this Bring to Front operation would require memory 
proportional to the number of objects in the entire drawing. 
The approach explained here requires only memory for the 
number of objects in the selection.) 

The problem is that sometimes, implementing undo with the 
basic command object is inefficient, impractical, or actually 
impossible. One way around this difficulty is to use the technique 
of filters and sieves in conjunction with command objects. Neither 
MacApp, TCL, nor the Prograph ABCs implement filters and 
sieves, although the Lisa Toolkit did.[2] I have added a 
rudimentary version of filters and sieves to the Prograph ABCs, 
and this article is about that implementation and about how you 
can make use of this technique in your applications. 

To illustrate these ideas, I have implemented two small 
applications that use the technique of filters and sieves: an icon 
editor, and a modified version of the MiniQuadWorld 
application.[2] The Prograph version of both these apps is on 
the associated MacTech Magazine diskette, along with the its 
full source code (in standard Prograph project and section files). 


INTRODUCTION TO FILTERS AND SIEVES 

Filters and sieves address situations where there is just not a 
reasonable way to implement undo for the user. The operations 
in question are not those for which undo is simply impossible — 
how do you get the LaserWriter to suck back in the paper after 
you have issued a print command, for example — but rather those 
operations that from the point of view of the average user should 
be undoable, but which you know will take too long, consume 
too much space, or are just computationally intractable. So, if 
these operations are too difficult to undo in reality, then we will 
just fool the user into thinking that they are undoable. And the 
way to do that is to fool the user into thinking that we have ever 
done them at all: that way we never really have to undo them! 

Let’s consider a very small example. Suppose we are 
implementing a structured graphics editor like MacDraw or 
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Canvas. Further suppose that we want to provide the user with 
the ability to change the fill pattern of a shape, and that to 
undo this operation is extremely difficult. (Yes, I know that 
undoing this type of operation is actually trivial. Let’s just 
pretend that it is extremely difficult.) Yet, we want to provide 
the user with the ability to undo fill pattern changes. We can 
provide undo for this operation if we just fool that user that we 
have ever performed the fill pattern change in the first place. 
Since we haven't really changed the fill pattern, then undoing it 
is easy-we just stop fooling the user and the status quo, which 
never really changed, is again revealed. We fool the user by 
modifying the drawing code something like this: 


PROCEDURE TShapeGraphicalView.Draw(area: Rect); 


PROCEDURE FilterAndDrawShape(shape: TShape) ; 
VAR tempShape: TShape; 
BEGIN 
IF shape <> newlyPatternedShape 
THEN shape.Draw {this shape is NOT the special one } 
ELSE BEGIN 
tempShape := shape.Clone; 
tempShape.SetFillPattern(newFillPattern) ; 
tempShape. Draw; 
tempShape.Free; 


END 
END; 
BEGIN 
SELF .fDocument .EachShapeDo (FilterAndDrawShape) ; 
END ; 


This code enables the view to check whether each shape 
in the document is a special shape that should not be drawn in 
the normal manner, but rather in a special way — in this 
example with a new fill pattern. Thus the shapes in the 
document are filtered through a sieve that allows most shapes 
to pass through and thus be drawn unchanged. But this sieve 
catches one special shape, the one referenced by the variable 
newlyPatternedShape, doesn’t let this shape be drawn, but 
rather clones it, changes the fill pattern of the clone, draws the 
clone, and then throws the clone away. This is conceptually 
represented in Figure 1. (Zhe small code fragment above is not 
at all representative of the way in which filters and sieves would 
actually be used, nor of how they would be added to an 
application framework. It is merely illustrative of the idea of 
filtering. More realistic code will be shown later.) 





Virtual View 
(displayed in the window) 


Actual View Filter 


Figure 1. Conceptual model of a filter that alters the display of a 
single object in the view presented to the user. 
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What we have done here is to present to the user the 
illusion that the shape’s fillPattern has changed. In reality, of 
course, it has not. Thus, if the user wants to undo this action, 
all we have to do is nil out the newlyPatternedShape reference 
and re-draw the view. The old pattern will automatically be 
drawn. If, on the other hand, the user wants to continue 
modifying the drawing, then we need only actually perform the 
pattern change just before we execute the next request from 
the user. With this pattern change thus ‘committed’, we need 
only nil out the newlyPatternedShape reference-there is no 
need to re-draw the view since the screen is already showing 
the shape drawn with the new pattern. At this point the 
pattern change operation cannot be undone. 

It is possible to consider using filters and sieves when the 
data of the application is inherently structured, as is the case in 
graphics editor like MacDraw or Canvas, a database 
application, word processor, etc. It is not so easy to apply 
when the data of the application is unstructured, as in a 
bitmap editor. In an application with an unstructured store, it 
is not reasonable to have a filter that will distinguish one of 
the unstructured bits in the document and process it 
differently. However, a technique that can sometimes be used 
to get an effect similar to that of filters and sieves is the 
technique of transparencies. Like filters and sieves, 
transparencies enable you to present to the user the illusion of 
having performed some operation, when in reality you have 
not done so. As with filters and sieves, this enables you to 
easily undo the operation. With transparencies, you 
superimpose additional image data in such a way that it can 
add to or subtract from the actual image data. Figure 2 
illustrates the conceptual model of transparencies. The 
technique of filters and sieves, and the technique of 
transparencies are similar, so I will describe an implementation 
that will add both techniques to the Prograph ABCs. 





Virtual View 
(displayed in the window) 
Figure 2. Conceptual model of a transparency that adds to (or 
can subtract from) the display of unstructured data in the view 

presented to the user. 


Actual View 


Transparency 


Filters and Sieves in an Application Framework 


The code fragment shown in the last section is not 
representative of the way in which you would use filters and 
sieves in a large application. This is because the approach in 
that fragment would lead to a situation in which the quirks of 
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each operation’s undo requirements would be reflected in the 
structure of the view’s Draw method - the depths of 
unmodularity! A more uniform, modular, and scalable 
mechanism is needed. One way to do this is to combine the 
notions of filters and sieves with that of command objects. 
Each command object would have a Filter method that would 
traverse the objects in the document, and enable that command 
object to specially process certain objects, in whatever way is 
necessary for the operation that the command implements. 
The view would call the current command’s Filter method to 
perform tasks like drawing or processing of mouse clicks. 

Let’s sketch out how this more modular approach would 
work for the same operation examined above: changing a 
shape’s fill pattern in a structured graphics editor. Assume the 
existence of TShapeView, TShapeDocument, and 
TChangeFillPatternCommand classes that provide the standard 
behaviors that you would expect in an application framework 
like MacApp, TCL, or the ABCs. In addition to this standard 
behavior, command objects have a FilterAndDo method, 
documents have an EachShapeDo method, and views have a 
slightly modified Draw method as shown here (expressed in a 
generic textual object-oriented language that just happens to 
look a lot like Object Pascal): 


PROCEDURE TShapeGraphicalView.Draw(area: Rect); 


PROCEDURE FilterAndDrawShape(shape: TShape) ; 
BEGIN 
shape.Draw; 
END; 
BEGIN 
SELF .fDocument.EachShapeDo(FilterAndDrawShape) ; 
END; 


PROCEDURE TShapeDocument .EachShapeDo ( 
| PROCEDURE DoToShape(shape: TShape)); 
VAR tempShape: TShape; 
shapeList: TList; 
BEGIN 
IF gLastCommand <> NIL THEN 
IF gLastCommand.fDone THEN 
IF gLastCommand.fFiltering 
THEN gLastCommand.FilterAndDo (DoToShape) 
ELSE BEGIN 
shapeList := SELF.GetShapeList; 
tempShape := shapeList.First; 
WHILE (tempShape <> NIL) DO 





BEGIN 
DoToShape(tempShape) ; 
tempShape := shapeList.Next; 
END ; 


END; 
END; 


PROCEDURE TChangeFillPatternCommand.FilterAndDo ( 
PROCEDURE DoToShape(shape: TShape)); 


VAR tempShape: TShape; 
shapeList: TList; 


BEGIN 
shapeList := SELF.GetShapeList; 
tempShape := shapeList.First; 
WHILE (tempShape <> NIL) DO 
BEGIN 


IF (tempShape <> 
SELF. £NewlyPatternedShape) 
THEN DoToShape(tempShape) ; 
{this shape is NOT the special one } 
ELSE BEGIN 
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tempShape := tempShape.Clone; 
tempShape.SetFillPattern(newFillPattern) ; 
DoToShape(tempShape) ; 
tempShape. Free; 
END; 
tempShape := shapeList.Next; 
END; 
END; 


Or, as _ in eee as shown in Figure 3. 


Let the filtering command object 
manage the operation. 
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Figure 3. Basic use of filters and sieves with command objects 


FILTERS AND SIEVES IN CPX 
Approach 


There were two somewhat conflicting goals in my 
approach to adding filters, sieves, and transparencies (FST) to 
the Prograph ABCs: my first goal was to produce a design that 
was good enough to use on several Prograph projects I was 
working on, and hopefully, would be useful to other Prograph 
developers. The second goal was to modify the ABCs as little 
as possible so that the FST section would be easy to port to 
new versions of the ABCs as they were released. These goals 
are in conflict because to FST requires modifications throughout 
the command handling apparatus of a framework, thus I had to 
make some compromises. 

I had to be able to distinguish a command that used FST 
from a command that didn’t. I also had to add an extra 
operation in the command handling algorithm: committing a 
FST command operation just before it was disposed. I had to 
have both the filtering mechanism for structured documents 
and the transparency mechanism for unstructured ones. Thus, 
the obvious steps looked like: 

e adding a boolean ‘Filtering?’ attribute to Command 

e adding a ‘Commit Command’ step to the Commander’s 
processing of commands 

e adding a Filter & Do method to Command, making use of 
the Prograph inject mechanism to have this single method 
accomplish different tasks, and 
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e adding a new drawing step (transparencies) to the already 
multilevel drawing algorithm used in the ABCs. 


Adding a boolean ‘Filtering?’ attribute to Command 

I expected this to be the easiest step, but it turned out to 
be the hardest. While adding an attribute to a class in Prograph 
is just a single mouse click, there are a lot of side effects when 
that class is the ancestor to a large number of classes with 
aliases in many different sections, and when there are instances 
of that class (or its subclasses) scattered throughout your 
application. The Command class is the ancestor of more than 
15 classes in the ABCs, and instances of many of these classes 
(e.g., Menu Behavior, (Click or Draw) Behavior, etc.) are 
created by the editors while you are designing your application 
with Prograph’s graphical interface builder, the ABEs. In fact, 
after I finally realized that adding the attribute was not going to 
work, just backing out of this change took over an hour. 

I still needed to add something like a boolean attribute to 
Command. What I ended up doing was using a method as a 
virtual attribute. Since the value of the Filtering? attribute that I 
wanted to add was not going to change for the lifetime of any 
particular instance, and since the value would be the same for 
all instances of a given Command subclass, I added a method 
Filtering? to Command that just returns FALSE. When you 
subclass Command to make a filtering command, you just 
overshadow the Filtering? method and change its 
implementation to return TRUE. 


Adding a ‘Commit Command’ step to the Commander 

This turned out to be very easy. In the standard version of 
the ABCs, the Commander disposes of the last command object 
as the first step in processing a new one (in Commander/Do 
Command). While I could have just instructed Prograph 
programmers using my FST unit to perform any commit action 
in their command subclass’s Dispose method, I felt this was 
probably something that would be a common source of 
programming errors, so I added a Commit method to 
Command, and a call to this method in Commander/Do 
Command. Most filtering subclasses will override Commit to 
perform the operation associated with the command, and store 
the results in the document. 


Adding a Filter and Do method to Command 

This turned out to be less elegant than I hoped for, 
primarily because the differing arities for the different uses of 
Filter & Do make a single implementation of Filter & Do 
impossible. When the task to be done by the filtering 
command object is drawing, then there is no return value from 
the operation. However, when the task is determining the set 
of objects currently shown to the user, there is a return value, 
the list of objects. And when the task is processing a mouse 
click, there is an additional input value, the click point. 

The inject operator in Prograph is powerful and it lets you 
do some really nifty stuff, but the methods that use inject have 
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the same arity matching requirements as any other method. 
This arity difference meant that one single abstract Filter & Do 
method could not be designed. In effect, what I had to do was 
to implement three methods: Filter-&-Do-one-input-and-no- 
return-value, a Filter-&-Do-with-one-input-and-one-return-value 
and a Filter-&-Do-with-two-inputs-and-one-return-value. It 
didn’t feel real elegant, but there didn’t seem to be any way 
around it. (I guess I shouldn’t feel so bad, since even the 
designers of Smalltalk had to make exactly the same 
compromise that I did. The Smalltalk equivalent of inject is 
perform; if you look at the Smalltalk sources you will see the 
inelegant but necessary perform: (one arguments), perform: 
with:(two arguments), perform: with: with: (three arguments), 
and perform: withArguments: (many arguments). ) 

Rather than pick method names that were so generic as to 
be almost meaningless, I decided to name the three Filter & Do 
variants in a way that suggested their most common uses: Filter 
& Draw, Filter Virtual Document, and Filter & Process Click. 
All filtering commands must override all of these methods. 


Adding a transparencies 

Adding transparencies to the ABCs turned out to be quite 
straightforward. After the standard View/Draw Content method 
executes, the Draw Virtual Content checks to see if there is a 
filtering command currently being stored by the Commander. 
If so, then that command is given the opportunity to draw its 
‘transparency on top of the already drawn view. (See 
Figure 4.) It is up to the individual application and command to 
determine how to store this virtual data, and how to make sure 
that the virtual data can both add to and subtract from the view 
of the data shown to the user. 
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The currently stored command object 


is not a filtering command, so there is 
no virtual content to draw. 
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Figure 4. Adding transparencies to the ABCs. 


USING FILTERS AND SIEVES 


I implemented two small applications that use my FST section. 
While these applications are far from being full-bodied 
applications, they do show how these techniques can be used 
in real products. 


Structured Graphics Editor 

The small structured graphics editor that I built has one 
window that uses ordinary vanilla command objects, and one 
that uses command objects with filters and sieves. (See 
Figure 5.) There are only 4 operations that a user of this app 
can perform on the geometric shapes shown in the window: 
select any number of shapes, clear any number of shapes, 
rotate any number of shapes by 45°, and recolor a single shape. 
Of these operations, all are undoable except selection. In the 
standard window (with vanilla commands) undo for each of 
the undoable operations is provided with the standard undo 
mechanism, but in the filtering window, undo for all three of 
the commands is provided for with filters and sieves. Thus, 
examining the source for this application will enable you to 
quickly compare and contrast these two approaches to undo. I 
purposely designed and implemented these windows to be as 
independent as possible to assist you in this comparison. 
While it would have been possible to have either as the 
subclass of the other, I believed that this would have been an 
arbitrary code sharing decision, and not a conceptually clean 
design that would be the easiest to learn from. 


e SS \ntitied - A Filtered Quad Window == 





Figure 5. The small structured graphics editor modified to use 
filters and sieves for undo. 
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This application is a modification of the MiniQuadWorld 
app described in an earlier MacTech Magazine article. I tried to 
make the minimal modifications to this app to add the use of 
filters and sieves for undo, so this app is indicative of the kind 
of work you would have to do to add filters and sieves to an 
existing application. 

Let’s examine what I had to do to add filters and sieves to 
this app. First, I had to make a new document subclass that let 
the current command control how a search for a particular 
object in the document was conducted when the user clicked 
in the window’s view. This meant that I had to modify the 
Find Quad under the Click method, but this was the only 
method I had to change. (I did have to add one new 
Document method: Get Virtual QuadList.) Since I was not 
using transparency in this app, my view class descends just 
from View and not from View with Transparency. I did have to 
modify this view’s Draw method to let the command object 
manage the drawing operation. A new window subclass was 
needed only because the ABCs require a new window subclass 
for every kind of window, not because of filters and sieves. I 
then added new command classes for each of the undoable 
operations. 

To make a command subclass use filters & sieves involved 
the secbilal: steps Sia Figure 6): 






ieee aneee rennet BEF 
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See 
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ia 
] Commit the rotation operation that this 
=|) | command makes the user believe has 
mI || Perform the view’s drawing action, taking into 
S| 





account the filtered rotation operation. 


Process a mouse click in the view, taking into 
account the filtered rotation operation. 
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Figure 6. The method overloading necessary to use filters and 
sieves in a command object. 


¢ Make sure that the command’s Do, Undo, and Redo just set 
things up for the particular state desired, as opposed to 
actually performing the command’s basic operation (e.g., 
clearing) 

e Overload the Filtering? method and change its return value 
to TRUE 

e Overload the Filter & Draw and the Filter & Process Click 
methods to control drawing and mouse click operations 
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when the command has been executed but not committed. 
Figures 7 and 8 show these methods for the Filtered Rotate 
Quad Cmd class. 


e Add a method to return the set of objects currently being 


shown to the user, the virtual document data. In this 
application, this method is named Get Virtual Quadlist. 


== @ 1:1 Filtered Rotate Quad Cmd/Filter & Draw =a) 
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VISESLLSITSEELAAAISETELAATTEELAA DD Ds 





Rotate Quad 
Command >» 
Zz 


This is the operation that is 
expensive to undo, so perform 
it on a clone. 





Figure 7. The Filtered Rotate Quad Cmd/Filter & Draw method. 


UNDO THE IMPOSSIBLE IN PROGRAPH CPX. 45 | 








EE @ 1:1 Filtered Rotate Quad Cmd/filter & Process Click =9 a @=as 1S @ 1:2 Rotated quad under click? 28 Sse: 


«Filtered 
Rotate Quad 
evan beans click pt 





<<Quadrilateral>> <¢<Quadrilateral>> 
(unaltered) (rotated) local click pt 
LULL LULL LLL LAALLLLL LLL UD PLELLLTLLLLLLELLLLLTTLLE, 


Test the rotated one for 
the click, and if the test 
is successful, pass the 


UNALTERED one on for further 
processing. 


«Filtered Quads 
Rotate Quad to rotate 
Command >> (list) Quad local click pt 
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Figure 8. The Filtered Rotate Quad Cmd/Filter & 
Process Click method. 


Icon Editor 





Figure 9 shows the main window of the small icon 
editor I wrote that uses transparencies to implement undo 
for the icon editing operation. (The functionality of this 
small app is modeled after the icon editing app used in the 
MacApp 3.0 tutorial.) 


2oom Out SL, 


Invert 31 


to rotate 
(list) Quad 


This is the operation - 
that is expensive to [7 
undo, so perform 

it on a clone. 





Figure 9. The main wou oh he icon editing app which uses 
transparencies to implement undo for the editing operation. 





Transparencies turned out to be a very natural and easy 
way to implement undo in this application. Figure 10 
shows the important pieces of code involved in the view’s 
drawing operation. 
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Figure 10. The transparency drawing code for the icon view. ¢ Integrated support for Metrowerks CodeWarrior. 
This code retrieves the data stored in the transparency and ¢ Automatic text wrapping without those oreney 
draws that data in a manner similar to, but not identical with, carriage returns. 
the main drawing code of the view. The difference is that the ¢ The integrated PopupFuncs support now 
transparency has to be able to, in effect, erase portions of what recognizes Rez, Fortran and 68K assembler 


was drawn by the main drawing code. source files. 
e Electronic documentation with interactive 


browser, so the information you need is always 
WHAT WORKED AND WHAT DIDN’T at your fingertips. 
¢ Tools from Bare Bones Software’s freeware 
collection. 
¢ BBEdit freeware and shareware extensions. 
e The BBEdit Extension Developer’s Kit. 


This all worked about like I expected it would, although with a 
few small surprises. Because much of the ABCs standard 
functionality (saving, printing, etc.) is not implemented with 
undoable commands, and because I was now fooling the user 
by presenting something that wasn’t really stored in the 
document, I had to take care not the fool the framework also. 
For example, when printing or saving, I had to make sure that 
any filtering command was committed first. 

Certainly, if Prograph International added FST to a future 
release of the ABCs, they would be able to do a smoother job 
of integrating, making the job of the application implementor a — 
little easier. Until then, I hope my filtering unit is of some use. 


Take some really cool software for a spin. 

On top of all of that, the CD includes demos, 
updates, special offers and information from 
industry leaders, including: Aladdin Systems, 
Language Systems, MacTech Magazine, 
Mathemeesthetics, Mind Vision Software, Onyx 
Technology and Symantec. 


How do I get mine? 
Look in the Mail Order Store section of this issue 
for info about ordering BBEdit 3.1 or give us a call. 
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By Mike Scanlin, Mountain View, CA 








METHOD DISPATCHER 


One of the main reasons why I don’t like object oriented 
languages is because of the inefficiencies the language usually 
introduces on the runtime code. If you’ve ever traced through 
a method dispatch routine then you know what I mean (what 
ever happened to the days of simple, direct JSR’s?). This month 
you have a chance to write a fast method dispatcher. Who 
knows? If it’s efficient enough I might just toss my assembler 
and use your dispatcher with a high level language instead... 
The prototype of the function you write is: 
typedef unsigned short ushort; 


typedef ushort ClassID; 
typedef ushort MethodNumber; 


MethodAddress 

FindMethod(theClassID, theMethodNumber) 
ClassID theClassID; 

MethodNumber theMethodNumber; 


TheMethodNumber is the number of the method you're trying 
to find the address of and theClassID is the ID of the class 
you want it for. You'll pass theClassID to a function called 
GetClassPtr to get a pointer to a Class data structure, which 
looks like this: | 
typedef void *MethodAddress; 
typedef struct { 

MethodNumber methodNumber; 

MethodAddress methodAddress; 
} MethodEntry; 


typedef struct { 


ushort inheritedCount; 

ushort inheritedClasses[15]; 
MethodNumber largestMethodNumber; 
ushort methodCount; 


MethodEntry methods[]; 
| Clase... *GlassPtr: 


The function GetClassPtr will be part of my test bench, 


although you'll have to implement at least a rudimentary 
version of it to test your program (or you can e-mail me for a 
sample version): 

ClassPtr 

GetClassPtr(classID) 

unsigned short classID; 

If GetClassPtr returns -1 (kClassNotFound) then the class cannot 
be found and your FindMethod routine should return 0 
(kMethodNotFound). I will be providing sample data and a 
sample GetClassPtr function for those who are interested. To get 
a copy, send me e-mail at scanlin@genmagic.com (internet) or 
any of the Programmer Challenge addresses listed on page 2. 

Once you have a ClassPtr you should look in that class’s 
methods[] array to see if you can find an entry whose 
methodNumber is equal to theMethodNumber. Methodsl] is a 
variable-length array (thus, making Class a variable-size 
structure) containing methodCount number of entries which are 
sorted smallest to largest by methodNumber. MethodCount is 1- 
based and is always greater than zero. If you find a match then 
you should return the corresponding methodAddress. 

If you don’t find a match then you should look at the 
inherited classes (starting with index zero) to see if the method 
is implemented by one of this class’s superclasses. We support 
multiple inheritance here and the number of classes we inherit 
from is stored in inheritedCount (which will be from zero to 
15). The class IDs of the classes we inherit from are stored in 
the inheritedClasses[ ] array. You can pass any of the entries in 
inheritedClasses to GetClassPtr to get a ClassPtr to that class. 

If you can’t find the requested methodNumber in any part 
of the inheritance tree then FindMethod should return zero 
(kMethodNotFound). 

Here’s a simple example. These 54 bytes (starting at 
location 0x1000) represent class ID 5: . 
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were powerful, wait until you program with 
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Manager 6.0 & 7.0 
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For quick relief, call 
800-309-0355 today. 


Get even more relief: Try QUED/M 2.7 now for just $69! You'll get a 
ney back guarantee too! Call now to order. 800-309-0355. 





Presenting the extra-strength text editor. 


Of course, QUED /M 2.7 still has all the features 
that make it easier to use than any other text editor: 


= Macro Language lets you automate 
tedious tasks 


«=> Search and Replace through multiple 
unopened files and using GREP 
metacharacters 


File comparisons using GNU Diff 


Unlimited undos and redos 





=> 10 Clipboards that can be edited, saved, 
and printed 

Customizable menu keys 

Do Script support = Text folding 

= Display text as ASCII codes 


Plus many more features! 
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1000:00000000 00000000 00000000 00000000 
1010:00000000 00000000 00000000 00000000 
1020:00680003 0023AAAA AAAAOO57 BBBBBBBB 
1030:0068CCCC CCCC 


The short at location 1000 (inheritedCount) tells us that there 
are no inherited classes for this class. The short at location 1022 
(methodCount) tells us that this class has 3 methods. 
Methods[0] is from 1024 to 1029; the methodNumber is 23 and 
the methodAddress is AAAAAAAA (this is just test data to 
illustrate the structure). Methods[1] is from 102A to 102F and 
methods[2] is from 1030 to 1035. The short at location 1020 
(largestMethodNumber) is equal to the methodNumber of the 
last MethodEntry in the list (which is the largest methodNumber 
overall since the list is sorted). In other words, the expression 


theClassPtr->largestMethodNumber == theClassPtr-> 
methods [theClassPtr->methodCount-1].methodNumber is 
always true. 


If this class had inherited from class 7 and class 9 then it 
would have looked like this instead: 
1000:00020007 00090000 00000000 00000000 
1010:00000000 00000000 00000000 00000000 


1020:00680003 0023AAAA AAAAO057 BBBBBBBB 
1030:0068CCCC CCCC 


In either case, if you call GetClassPtr(5), since this is class 5 
we're looking at, you would have the value 0x1000 (as type 
ClassPtr) returned to you. 

Since I’ll be calling FindMethod several thousand times 
with the same set of classes (just like a real runtime system!) 
you'll probably want to implement some kind of cache. And 
since it is desirable for runtime systems to take as little memory 
as possible, we’re going to have a rule that says your code 
cannot use more than 16K of memory for its cache (use a static 
to keep a pointer to it). The total number of methods in the set 
of classes I'll be testing with is about 5000, numbered from 1 to 
5000. The total number of classes is about 400, numbered from 
1 to 400. Those 400 classes will implement an average of 15 
methods each and will inherit from an average of 5 other 
classes (that’s 5 total, once you’ve walked the entire inheritance 
tree for a particular class). Of course, some methods will be 
called frequently while others are hardly ever called. 

Because this is a little complex, I’m going to give you the 
brute force way of doing what I’ve described. I’m sure you can 
do better than this (I’ve used short variable names so that the 
code will fit in the magazine column): 

MethodAddress 
FindMethod(cid, mn) 
ClassID cid; 
oe mn ; 


ClassPtr ep: 
MethodAddress addr; 


int 1; 

cp = GetClassPtr (cid) ; 

if (cp == kClassNotFound) 
return kMethodNotFound; 


/* look in this class */ 
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i = 0; 
do { 
if (mn == cp->methods [i] .methodNumber) 
return cp-?>methods[i] .methodAddress; 
it+; 
} while (i < cp->methodCount) ; 
/* look in superclasses */ 
Lt = Q: 
while (i < cp->PinheritedCount) { 
addr = FindMethod( cp->inheritedClasses[i], mn); 
if (addr != kMethodNotFound) 
return addr; 
itt; 
} 
return kMethodNotFound; 


E-mail me if you have any questions or if you want the 
sample data and GetClassPtr function. And if you want to see 
your name in print all you have to do is either enter a 
challenge or have me use one of your suggested challenges. 


Two Montus AGO WINNER 
Congratulations to Kevin Cutts (Schaumburg, IL) for winning 
the Poker Hand Evaluator Challenge. And kudos to Gustav 
Larsson (Mountain View, CA) for being 60% smaller and only 
about 4% slower than Kevin. 

Here are the times and code sizes for each entry. Numbers 
in parens after a person’s name indicate how many times that 
person has finished in the top 5 places of all previous 
Programmer Challenges, not including this one: 





























Name time code 
Kevin Cutts (3) 317 6022 
Gustav Larsson 331 2656 
Jeff Mallett (3) 331 9428 
Ernst Munter (5) 457 2516 
Dave Darrah (1) 749 2996 
Raffi Kasparian (1) 1230 7394 





Kevin wrote four different versions of his BestHand 
routine; one for every combination of the Booleans 
wildCardAllowed and straightsAndFlushesValid. That’s a great 
idea for performance but because of space constraints, we’re 
only listing the BestHandNoWild version which is for the case 
where wild cards are not allowed but straights and flushes are 
valid (which is probably the typical case for poker). The source 
code to the remaining cases can be found on-line or on this 
month’s code disk. 

Here is Kevin’s winning solution: 


JANUARY SOLUTION -POKER- 
by Kevin M. Cutts 


finclude <stdlib.h> 
fHinclude <stdio.h> 


typedef unsigned char Card; 
typedef struct SevenCardHand 


{ 
Card cards[7]; 
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When you can't afford to slip, 
and the product just has to ship... 
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THE MAc GROUP 


intense, focused debugging 
aimed at helping you ship 


800 Sync 


Wait 


796-2924 
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sevenCardHand; #define fullHouse 0x/7000 
define flush 0x6000 
typedef struct FiveCardHand #tdefine straight 0x5000 
#define threeAlike 0x4000 
Card cards[5]; #define twoPair 0x3000 
} FiveCardHand; #define pair 0x2000 
short ComparePokerHands #define nonCard Oxff 
SevenCardHand *, /* These four functions are custom to handle the four bools wild and flush */ 
SevenCardHand * unsigned int BestHandNoWild(SevenCardHand *theHand, 
FiveCardHand *, FiveCardHand *theBest) ; 
FiveCardHand * unsigned int BestHand(SevenCardHand *theHand, 
Boolean FiveCardHand *theBest, Card wildCard); 
Card, unsigned int BestHandNoFlush(SevenCardHand *theHand, 
Boolean, FiveCardHand *theBest, Card wildCard) ; 
void *); unsigned int BestHandNoFlushNoWild(SevenCardHand *theHand, 











FiveCardHand *theBest):; 





/* Used to remove the suit information and leave only the count from the card */ 





unsigned char theValue[] = [ BestHandNoWild 
Ol oe id pty S40 tate 
Os Lelio rte de Oe7 879710511, 12, unsigned int BestHandNoWild(SevenCardHand *theHand, 
0,152,35465, 66/1 58.9.10,11,12; FiveCardHand *theBest) 
0,1,2,3,4,5,6,7,8,9,10,11 12 { 
}; /* How many of each card value encountered */ 
unsigned char handValues[13]; 
ee ee /* How many of each suit encountered */ 
unsigned char theSuit[] = { unsigned char handSuits [4]; 
U5 05060, “a -0,030,0,0,0,0,0, /* Bit field describing on a suit by suit basis how populated the hand is */ 
Ve dh, le lsdstelslatct leds short handRuns [4]; 
DD ge peepee ese register short i; 
i ee ee ate Po ee eee PG eee es re short j; 
13 Card bestCard, bestPair, goodPair, bestTri, bestQuad; 
Card *cardPtr; 
hi A bit for each card value (aces have two bits) */ short runSweep, runResult, rtnCount; 
unsigned short theValueBit|] = 
0x1000 ,0x800,0x400 0x200,0x1 00, 0x80, 0x40, /* Zero out all of the counts */ 
0x20,0x10,0x8,0x4,0x2,0x2001, *(long *)&handValues[0] = 
0x1000,0x800,0x400,0x200,0x100,0x80,0x40, *(long *) &handValues [4] 
0x20,0x10,0x8,0x4,0x2,0x2001, *(long *)&handValues[8] = 
0x1000,0x800,0x400, 0x200, 0x100,0x80,0x40, handValues[12] = 0; 
0x20,0x10,0x8,0x4,0x2,0x2001, *(long *)&handSuits[0] = 0; 
0x1000 “0x800,0 0x400,0x200,0x100,0x80,0x40, *(long *)&handRuns[0] = *(long *)&handRuns[2] = 0; 
0x20,0x10,0x8,0x4,0x2,0x2001, 
le /* Now accumulate the values */ 
for (i=0, cardPtr=theHand->cards; i<7; it+, cardPtrt++) 
#define fiveAlike 0xa000 { 
define straightFlush 0x9000 handValues[theValue[*cardPtr]]++; 
#tdefine fourAlike 0x8000 handSuits[theSuit [*cardPtr]]++; 
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It's Macintosh Accounting At Its Best 


POWERFUL 


FlexWare is designed FlexWare’s accounting F Large businesses consis- 
to give you almost features and reporting ee tently chose FlexWare 
unlimited possibilities capabilities give you | because of its exceptional 
as your company information you'll rely H speed on network and 


grows. daily és make smart client/server systems. 
usiness decisions. 


Meet your clients’ needs with the FlexWare Development 


System. FlexWare is an integrated, modular, MacWorld award- 

winning accounting program that you can modify and customize Hlex\ \ are 
to suit each of your clients’ requirements. Take advantage of 

FlexWare’s top performance and adaptability. It’s flexible. It’s ACCOUNT 


powerful. It’s fast. Call Jack Robinson at extension 2309 for 
information on the FlexWare Development System. 


STATE OF THE ART 8211 Sierra College Blvd., Suite 440, Roseville, CA 95661-9406 ¢ © 916-791-7730 © FAX 916-791-5525 ¢ 1-800-447-5700 


ACCOUNTING SOFTWARE 





handRuns [theSuit [*cardPtr] ] |= theValueBit [*cardPtr]; } 
} 
/* First count the pairs, tris, quads and penta */ /* Now check for a straight flush */ 
bestCard = bestPair = goodPair = bestTri = bestQuad = nonCard; define CHK_SUIT_NOWILD(suit) \ 
for (i = 12; i >= 0; i--) if (handSuits[suit] >= 5) \ 
{ { \ 
if (!(j = handValues[i])) continue; for (runSweep=0xlf;runSweep<0xlfff;runSweep<<= 1) \ 
ci ae ee { \ 
{ runResult = handRuns[suit] & runSweep; \ 
bestQuad = i; if (runResult == runSweep) \ 
break; { \ 
/* Transfer the five cards */ \ 
if (j == 3 && bestTri == nonCard) a (i=0, j=0; j < 5;it+) \ 
{ { 
bestTri =i; if ((theValueBit [theHand->cards[i]] & \ 
if (bestPair != nonCard) runSweep && suit == \ 
{ theSuit [theHand->cards[i]])) \ 
/* Full house */ [A 
break; theBest->cards[j+t] = \ 
theHand->cards [i]; \ 
. } \ 
else if (j == 2 && bestPair == nonCard) } \ 
return straightFlush; \ 
bestPair = 13 } \ 
if (bestTri != nonCard) } \ 
{ } 
/* Full house */ CHK. SUIT_NOWILD (0) ; 
break; CHK_SUIT_NOWILD (1) ; 
} CHK_SUIT_NOWILD (2) ; 
CHK SUIT_NOWILD(3) ; 
else if (j == 2 && goodPair == nonCard) /* Next comes four of a kind */ 
if (bestQuad != nonCard) 





goodPair = i; { 

/* Transfer the five cards */ 
else if (bestCard == nonCard) runSweep = 1; 

for {1=0,. 9=05 94 Ssa7*) 
pestCard = a3 { 
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a s 


created equal. 


Is your application taking cut So why should you join the 
& paste a little too literally when PAIGE revolution? TIME. Most 
it creates text? Are you tired of | programmers don’t have time to 


living in a monotype world? — reinvent the wheel. 


PAIGE” our text & page layout PAIGE was designed using 
programming library, is the ulti- no global variables and machine 
mate cross-platform solution. specific code has been isolated 

PAIGE provides the most into two small source files. This 
sophisticated features/functions strategy allows you to move your 
in the business. These include: application to other operating 


systems or platforms by chang- 


¢ Stylized Text 

e Shapes & Containers 
¢ Text Wrapping 

¢ Embedded Objects 

¢ Hypertext Links 

¢ Virtual Memory 

¢ Style Sheet Support 
¢ Multi-Level “Undo” 

¢ Royalty Free 


ing only platform specific code 
while maintaining full data and 
application compatibility. 

Join the hundreds of major 
software publishers using PAIGE 
as their total text solution. For 
complete technical/pricing sum- 
mary contact DataPak Software 
at 800-327-6703 or 200-573-9155. 





Macintosh e¢ Power Macintosh e Windows 





MPButtons 2.0 


Set of extensions to the MPW environment 


Commenting and uncommenting 
a portion of source code 













Function name popup 
(source overview and navigation) 











top Folder:Untitle 


Nia Siaimieirim 


find © 
replace /O; 





Up to 7 smart 
clipboards with 
executable contents 
(this one is pressed) 























One or more script-buttons 
execute your scripts 


Searching and pasting items 
from THINK Reference 2.0 









Development Kit includes API and examples 
for designing your own code-buttons... 


6.88y¥ & 








MPButtons ................ 
Development Kit ...... $149 
MPButtons with DK ..$199 
Discounts available! 
Ask for free demo now! 


Fax: (+42-2) 3112 037 
AppleLink: JMPSOFT Internet: jmpsoft@applelink.apple.com 











S OF T 


JMP Soft, Janskeho 2507 
155 OO Prague 5, Czech Republic 


















MPW is a registered trademark of the Apple Computer, Inc. THINK Reference 
is a trademark of the Symantec Corporation. MPButtons is a trademark of the JMP Soft. 
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if (theValue[theHand->cards[i]] == bestQuad) 


if 


theBest->cards[jtt] = theHand->cards [i]; 
else if (runSweep) 


theBest->cards[jtt+] = theHand->cards [i]; 
runSweep-- ; 


reich fourAlike | bestQuad; 


la Next is the full house */ 
if (bestTri != nonCard && bestPair != nonCard) 
{ 

/* Transfer the five cards */ 

for (i=0, j=0; j < 5;it+t) 

{ 

if (theValue[theHand->cards[i]] == bestTri | | 
theValue[theHand->cards[i]] == bestPair) 


f 
U 


theBest->cards[jtt] = theHand->cards [i]; 
} 
return fullHouse | (bestTri<<8) | (bestPair) ; 
} 
/* Now the flush */ 


define CHK FLUSH NOWILD(suit) \ 


if (handSuits[suit] >= 5) \ 
{ \ 
/* Transfer the five cards */ \ 
for (i=0, j=0; j < 5;itt) \ 
{ \ 
if (theSuit [theHand->cards[i]] == suit) \ 
{ \ 


} \ 
} \ 


return flush | bestCard; \ 


heBest->cards[j+t+] = theHand->cards[i]; \ 


} 





CHK_FLUSH_NOWILD 
/* Next the straight */ 
= handRuns [0] |handRuns [1] |handRuns [2] | handRuns [3]; 
for (runSweep=0xlf; runSweep < Oxlfff; runSweep <<= 1) 
{ 
runResult = j & runSweep; 
if (runResult == runSweep) 
{ 
/* Transfer the five cards */ 
for (i=0, j=0; j < 5;it+) 
{ 
if ((theValueBit [theHand->cards[i]] & runSweep) ) 


f 
L 


theBest->cards[jtt] = theHand->cards [i] ; 


\ 
J 


} 
return straight; 
} 
} 
/* and the three of a kind */ 
if (bestTri != nonCard) 
{ 
/* Transfer the five cards */ 
runSweep = 2; 
fOr (3-0, 3-06: < Sear) 
{ 
if (theValue[theHand->cards[i]] == bestTri) 











theBest->cards[jt+] = theHand->cards [i]; 


| 





else if (runSweep) 


theBest->cards[jtt] = theHand->cards [i] ; 
runsweep--; 
} 
} 
return threeAlike | bestTri; 
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/* Now two pair */ 
if (bestPair != nonCard && goodPair != nonCard) 
{ 
/* Transfer the five cards */ 
runSweep = 1; 
for (i=0, j=0; j < 5:itt+) 
{ 
if (theValue[theHand->cards[i]] == bestPair | | 
theValue[theHand->cards[i]] == goodPair) 
{ 
theBest->cards[jt+] = theHand->cards [i]; 
} 
else if (runSweep) 
{ 
theBest->cards[jtt+] = theHand->cards [i]; 
runSweep--; 
} 
} 
return twoPair | (bestPair << 8) | goodPair; 
} 
/* And finally a single pair */ 
if (bestPair != nonCard) 
{ 
/* Transfer the five cards */ 
runsSweep = 3; 
for Gi-),: 7-07 5 SS Sat) 
{ 
if (theValue[theHand->cards[i]] == bestPair) 
{ 


theBest->cards[jtt] = theHand->cards [il ; 
} 
else if (runSweep) 
{ 
theBest->cards[jtt] = theHand->cards [i]; 
runSweep--; 
} 
} 
return pair | bestPair; 
} 
/* Transfer the five cards */ 
runSweep = 4; 
ror (1-0, 9-0) | <. S317?) 
{ 
if (theValue[theHand->cards[i]] == bestCard) 


theBest->cards[jt+] = theHand->cards [i]; 





else if (runSweep) 


theBest->cards|[jtt+] = theHand->cards [il] ; 
runSweep--; 
} 


return bestCard; 








short ComparePokerHands ( 


SevenCardHand *handlPtr, 
SevenCardHand *hand2Ptr, 
FiveCardHand *bestlPtr, 
FiveCardHand *best2Ptr, 

Boolean wildCardAllowed, 

Card wildCard, 

Boolean straightsdAndFlushesValid, 
void *privateDataPtr) 


unsigned int handlValue, hand2Value; 
if (wildCardAllowed && straightsdAndFlushesValid) 
{ 
handlValue = 
hand2Value = 
} 
else if (wildCardAllowed) 
{ 
hand1lValue 


estHand(hand1Ptr, bestlPtr, wildCard); 
estHand(hand2Ptr, best2Ptr, wildCard); 


ww 


} 
else if (straightsdAndFlushesValid) 
{ 





handlValue = BestHandNoWild(handlPtr, bestlPtr); 
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ComparePokerHands 


= BestHandNoFlush(hand1Ptr,bestlPtr,wildCard) ; 
hand2Value = BestHandNoFlush(hand2Ptr,best2Ptr,wildCard) ; 


WHETHER YOU'RE HEADED TO CHICAGO, DAYTONA, 
OR POINTS UNKNOWN, SUMMIT BASICSCRIPT HELPS 
YOU ARRIVE IN STYLE. , 


The BasicScript Toolkit makes it easy and 

economical to add an award-winning scripting 

language fo your Macintosh, Power Macintosh, 

or Windows application. 

ia Easy-to-use APIs make it simple to integrate 
BasicScript into your application using C or C++. 

a st aha with the syntax of Microsoft Visual Basic 
and Visual Basic for Applications (VBA). 

ia Controls OLE Automation objects in Macintosh, . NetWare 
Windows, and Windows NT applications. 

ia Extensibility architecture allows you to add your own 
keywords fo the BasicScript language. 

a Available for Macintosh, Power Macintosh, Windows 3.1, Windows 95 
"Chicago", Windows NT 3.5 "Daytona", MS-DOS, 0S/2, SunOS, Solaris 2.x, 
HP-UX, AIX, SCO UNIX, Ultrix, IRIX, and NetWare. 

ia Runtime can be redistributed by your customer without royalties. 

a Script Editor with integrated debugger allows you to offer a complete 
Integrated Development Environment (IDE) for scripting. 

a Free technical support, comprehensive documentation, and numerous code 
samples keep your engineering costs to a minimum. 

i Licensed by = Delrina and other leading software companies. Named 
PC Magazine Editors’ Choice among cross-application macro languages. 


i Flexible licensing terms mean you can afford the finest scripting language on the 
market today. 


ee ee 


Mala CALL TODAY FOR YOUR FREE | 
$: eens) "TL evawuarion COPY, 315-445-9000 | 


Summit Software Company Fax: 315-445-9567 Internet: info@summsoft.com CompuServe: 71211,3504 





Put A Spelling Checker 
In Your Application 


Working Software offers several options for adding 
a spelling checker to your applications. Call us. 


THE FREE WAY - Add free Apple Events Word Services 
and our award-winning Spellswell 7 will work with your app 
as if built-in. (WordPerfect, Omnis 7, Eudora & InfoDepot use 
this.) Our FREE Word Services Developer Kit includes source 


code for a sample word processor to guide you. 
THE CUSTOM WAY -— Compile our OEM speller (MPW, 
Think C or Pascal) into your Mac and/or Windows applica- 


tion (takes 1-2 days). Legal, Medical & other dictionaries avail- 
able. Fees depend on your circumstances - call for details. 


Contact us for FREE Object-Only Demo and/or 
FREE Word Services Software Development Kit. 























Working Software, Inc. 


P.O. Box 1844 / Santa Cruz, CA 95061-1844 
(800) 229-9675 / (408) 423-4596 / FAX (408) 423-5699 
AppleLink D0140 / CompuServe 76004,2072 
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Solution Tools for HyperCard, AppleScript, OpenDoc’ and More! 










If you are a consultant, integrator, Mac manager, 
XCMD programmer or user, part developer, 
stack developer, or scripter, then you use Solution Tools. 



















If you don’t already know about Heizer Software (we've been here since 1984) then 
you owe it to yourself to find out more. 


Call, fax, or email us your address and we'll send you a FREE issue of our 
newsletter(mention code H197). We love HyperCard, so it’s loaded with tools and 
newsbits about HyperCard. In the comming months, you'll see us offer more and more 
solution tools for AppleScript, OpenDoc, and more. 


Here’s a quick sampling of some of our more popular products: 
Compilelt!” — The HyperTalk® Compiler $149 (0-0736) 
WindowScript® — The Interface Design Studio for HyperCard $ 149 (30-0737) 

“— OSA script editor and debugger $99 (30-0738) 
SCAuthor™ — Powerful tools for SuperCard® $79 (30-0739) 
HyperMarker™ — Quick and easy HTML editing $25 (30-0740) 


FileFlex™ — xbase database XCMDs that work wherever XCMDs do $119 (20-0741) 


ScriptWizard 


Heizer Software 
















1941 Oak Park Blvd., #30 * P.O. Box 232019, Pleasant Hill, CA 94523 
Orders: 800-888-7667 °* International: 510-943-7667 © Fax: 510-943-6882 


email: heizersw@aol.com ® ftp://ftp.netcom.com/pub/he/heizersw 











emark of Software Perspectives. FileFlex is a trademark of Component Software Corp. HyperCard, Hyperl 






by Steve Michel presents a lucid, 
complete discussion of how to 
use AppleScript to script the 
System 7.5 Scriptable Finder. 
Novice scripters and Mac 
Managers alike will find the 
‘information in this book 
invaluable. 

























The accompanying disk includes over 100 scripts 
along with popular scripting utilities such as 
Cron, OSAMenu, and FileTracker and a number 
of Scripting Additions. One of the best ways to 
learn scripting is to study existing scripts—the 
accompanying disk is a great resource for this 
purpose. $49 (30-0742) 
Steve Michel has worked as a freelance writer since 1987. He wrote 
the StacRWEEK (later renamed “Script Manager”) column for 
MacWEEK from 1988 to 1994. He is the author of five Macintosh 


books and has written scores of software reviews for various 
publications. 











ional. Prices guaranteed through 8/95. Satisfaction guaranteed. Compilelt! & WindowScript are trademarks of Heizer Software. Scrip!Wizard is a trademark of Full Moon Software. SCAuthor is a trademark of 


k, AppleScript, OpenDoc, Mac, & Macintosh are registered trademarks of Apple Computer, Inc. 





MacWeek's Score: AppleScript © @ @ ie: 


- { 
UserLand Frontier @ @ @ @! er re 


UserLand Frontier™ isn't just a language; it's a full-featured 


script development and runtime environment. It gives you the 
tools you need to get the job done in record time! return 


FRONTIER 3.0 FEATURES 
@ Outline-based script editor 
- Full search and replace 
- No 32K limit! 
@ Integrated Database 
- Scripts can communicate/share data 
@ Full-featured debugger 
- Breakpoints. step in/out 
- View/modify any script values 
@ Hundreds of built-in verbs 
- Full control of file system and OS 
- No osax needed for most scripts 
@ Full multi-threaded environment 


- Full-time agents: built in script scheduler 


PowerMac Native 
Version Available 


@ Professional programming lanquage 
- UserTalk is easy to learn and use; based on familiar lanquages 
- Case statement, continue/break, optional parameters, and more... 
@ Completely OSA compatible 
- Record, edit and run scripts in any OSA language 
- Execute UserTalk scripts from any OSA environment 
Find out what thousands of users have known since 1992: Frontier 


is the premier scripting system for the Macintosh™! 


To Order Or For More Information Call Userland Software, Inc. 


555 Bryant Street 
800/845-1772 Palo Alto, CA 94301 
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hand2Value 


hand2Value 





= BestHandNoWild(hand2Ptr, best2Ptr): 


BestHandNoFlushNoWild(hand1lPtr, best1Ptr): 
= BestHandNoFlushNoWild(hand2Ptr, best2Ptr); 


if (handlValue > hand2Value) return -1: 
if (handlValue < hand2Value) return 1; 


DON’T FORGET! 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 
productinfo@xplain.com 
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By various contributors 


Have You Seen Anything Cool? 


Another quest for good 
stuff at MacWorld... 


Our staff has assembled a near-random 
set of observations from various people 
who attended MacWorld Expo in San 
Francisco in January. They’re presented 
in a hodge-podge below. That’s fitting, 
given the helter skelter hit-and-miss 
nature of the four day event. 


What was hot? Well there was that 
weird guy with a Connectix QuickCam 
wired into his baseball cap recording 
anything that moved in the Penthouse 
booth. I heard he got some great shots 
and great quotes. Did she really say, 
“Do it again, over here where the light’s 
better”? 


Apple showed a great demo of an 
upcoming OpenDoc-based ClarisWorks 
in the Developer Showcase. This 
ClarisWorks, with one tool pallet in the 
belly of an animated bear and another 
as a traditional bar, demonstrates how 
OpenDoc allows the user interface to be 
tailored to different markets. 


There were not many Internet savvy 
apps. Guy Kawasaki's Emailer, by Fog 
City Software, looks good for those who 
support more than one service, but its 
lack of filters keeps it far from 
competing with Eudora. StarNine’s 
Macintosh list server looks very hot. It 
can process QuickMail and Internet 
messages with auto replies, activating 
other apps and more. 
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One developer reported that this was the first show where 
Performa owners discovered that their Macintoshes were good 
for more than typing school papers. All those doctors and 
lawyers are now seeing what fun they can have with QuickCam 
and Marathon on the Internet. 


The conference organizers wouldn’t allow booths in 
Developer Central to put padding under their carpet. Ooh, 
those dogs hurt! 


Main Event was showing their Apple Script development 
environment. It supports variable watching and changing on the 
fly, step tracing, pausing a script and running another in the 
paused script’s variable space, excellent point-and-click script 
building and a bunch of other cool tools for developing Apple 
Scripts. This is a must have for any Apple Script developer; let’s 
hope they finally ship it. 


Of course, MetroWerks released a new version, but I didn’t 
take the time to see it. Their tree reduction effort seemed to be 
a success if you count the number of people rushing to buy the 
printed version of their documentation. 


While looking for someone to comment on the Windows 
sessions for Macintosh programmers, we drew this comment, 
“Sorry, I can’t help you here. It repels me like a magnet. :-)” 


The show is smaller because of the large number of 
mergers and acquisitios that have taken place in the industry. 


Apple’s Pavilion set aside in a separate room continues to 
be a mistake. It’s difficult to navigate and it’s a very crowded 
and stuffy room. It needs to be back on the main show floor. 
Rumor has it that it will be this way in Boston. 


Connectix continued to have hot products at the show. 
People were continuously stacked up four across, eight deep, 
eager to drop their $99 for a QuickCam. One Symantec exec 
was seen buying two, one for a friend who couldn't get away 
from his booth in Developer Central. 
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QC: the Macintosh Testing solution. 


Subject your code to brutal stress 
conditions to make it break consistantly. 












Or use QC during the development cycle to 
casually detect block boundary overwrites, 
——, invalid BlockMoves, writes to location zero, 
—_| and more...saving countless hours of 


Copyright © 1993 | needless debugging. 
Onyx Technology 


On App/File Name Type 












QC 
Options for: America Online 2.0 

1A Test Name Category 
a with Beep 



















America Online 2.0 __ 
|_IN CONTROL 2.0 











Notify w/Icon in Menu i Preference 





Crossref Master Pointers ' Validation 
V iValidate Handle/Pointer | Validation 


V iDetect Write To Zero 
V iDereference Zero Checks 


















Sina! 7 Pareren ny (rer aaa 


¢ Works with any program without 
modification - source not required 

e Easy to use: just hit the hotkey. 

¢ Fast heap scramble and purge 

 Invalidates all free memory 

e Detects runtime block overwrites 

e Warns of DisposHandle on resource 
and ReleaseResource on handles. 








iCheck Dispose/Release 
| |/BlockMove Checking 





| |MemErr Detection 
Scramble Heap 


iPurge Heap — 





e Validates BlockMove destinations 30 DAY 
¢ Sophisticated heap verification NO QUESTIONS 
¢ Powerful API for precision control ASKED 
SPECIAL ey BACK ONYX TECHNOLOGY 
UARANTEE 7811 27th Ave W. 
$99 INTRODUCTORY Bradenton, = 208 
PRICE 





192.5152 AOL: OnyxTech ALink: D2238 CIS: 70550,1377 











MACINTOSH SEMINARS & CONSULTING | 





Richey Software Training provides 
professional, customized programming 
seminars and industry consulting. 


Rich content & hands-on lab 
exercises shorten your learning curve. 
On-site training is convenient — your 
team eliminates expensive travel costs 
and consuming down-time. 


in Professional training & consultancy 99 


that really hits the mark. “System 7 


- Debugging 
-SourceBug 








Call today to find out how Richey 
Software Training delivers professional 
seminars and consulting nationwide. 





Training Mac Programmers Since 1986 


707*869°2836 


AppleLink: RICHEYSOFT 


INTERNET: 70413.2710@compuserve.com 
P.O. BOX 1809, GUERNEVILLE, CA 95446-1809 





TRAINI NG 1994 Richey Software Training. All trademarks or regist 1 1 
th > owners. S$ 


ered trademarks are 
¢ property of their respective pecifications subject to change. 
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You mean there’s a whole ’nuther hall to get through? 


There were a number of Windows developers that came to 
Developer Central and asked about getting started in Macintosh 
programming. 


Wearing a QuickCam on a hat while walking around the 
show capturing pictures and video is a great way to meet 
everyone at the show. 


There were a number of people at the show who were 
amazed at how many tools and opportunities there were 
available on the Macintosh for developers. 


The show had at least 30% more attendance than last 
Macworld (maybe even more). 


People are over the phase of “is the Power Macintosh for 
real?” 


When (if ever) are they going to open the passageway 
between the Marriott Hotel (where all the keynotes are) and the 
Moscone Center? 


Developer Central was a resounding success. Everyone 
had space, the volume level was talkable, and the crowd 
passing through seemed to have a lot of developers in it. 


Microsoft seemed quite pleased with the response to their 
Windows for Macintosh developers sessions. 


There were simply too many interesting people at the show 
and not enough time to talk to them all. 


People just don’t seem to be giving out enough free 
samples, especially of expensive hardware! 


Staying up all night the night before the show to work with 
a small group of volunteers to get a demo going wore me out, 
but what a blast! 


At long last, it was a simple matter to get a really good cup 
of coffee within just a few steps of the convention center. 


The Williams Defender emulator looked really good. 
Maybe too good. Many people didn’t realize that the stand-up 
arcade machines had Macs inside, nor did they realize that 
Defender was for sale and available to run on their Macs at 
home. I shudder to think that it’s available for unlimited play at 
only $25 after I wasted a year of college dropping quarters. 


Ican’t believe I’m saying this, but the Apple Evangelism 
party was a great party. Ford puts on a good shindig. 
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=|(_] StoneTable Version 2.0 


se 31993 31994 | 31996 | 31997 |] 31998 31999 
31988 eee : 
31989 Break on through the limitations of the List Manager 
31990) eispevable StoneTableExtra 
drag cells in and between tables 
(31991 Row and column titles popup menus & check boxes 
31992 variable size row and columns draw boxes around multiple cells 
| 31993] move, copy, sort, hide, resize variable size grid lines 
31994 | rows and columns 





















31995. edit cells in place CodeWarrior C, MPW C (68K:or PPC) 

font, size, color styles per cell Think C, Think Pascal, MPW Pascal, Prograph CPX (68K only) 
(31996 “LDEF-like” custom drawing 68K StoneTable $150 StoneTableExtra $75 (per compiler) 
greater than 32K data per table PPC StoneTable $100 StoneTableExtra $25 (requires 68K) 
plus all List Manager functions International shipping (US Airmail) $10 


No royalty fees for applications 
aanAA 1 Demo - ftp://ftp.teleport.com/pub/vendors/stack/StoneTableDemo.hqx 


Language 
Tools Plus gives you the routines you need: OC/C++ 
to create a professional looking user interface. jo Pascal 
Then we make it work. It’s that simple. 


¢ For THINK C and Symantec C/C++ (5.0.4 and later) or THINK Pascal ] Saves Time 
Over 170 high-powered “set and forget” routines that automate and enhance: cx] Saves Mone y 
(wads 4 i event handling, windows, the tool bar, floating palettes, cursors, buttons, ] Easy to Use 
aters Edge Software picture buttons, scroll bars, menus (pull-down, hierarchical and pop-up), 
= list boxes, fields, Edit menu, clipboard, Dynamic Alerts, and more... 
Box 70022 © 2441 Lakeshore Road West E to} d a - 3 ; diat d 
Oakville, Ontario ® Canada L6L'6M9 ] | asy to learn and easy to use or novice, intermediate an 
Phone: (416) 219-5628 Substantial code reduction advanced programmers 
CompuServe: 73424,2507 ; ; if; . F . : 
ea ence aes Dramatic code simplification e Runs fast; needs little memory or disk space Ch pcilioraty, tenameTP2sd SEA 
Significantly less debugging e Safer than toolbox routines AppleLink Software SamplerSoleware 


Tools Plus for C/C++ or Pascal only $149 US or $199 US for both. System 6 and 7 compatible * No royalties Collection/Programmer Tools/Tools Plus 


(We accept VISA and American Express. Add $10 for shipping.) Disk also available by mail. 


Free Evaluation Kit: 


CompuServe GO MACDEV, 


Easy for your users To find out just how easy 
DragInstall is, call us at 
DragInstall’s unique drag-and-drop interface makes installing your software a 1-800-890-9880 


piece of cake for your users. And cuts down on your tech support calls. to receive a free demo disk. 


Or contact us at: 


Easy for you 


DragInstall’s Builder utility allows you to create complex installers in minutes 
not days. And without the need to learn a complicated scripting language. 


Ray Sauers Associates, Inc. 
1187 Main Avenue, Suite 1B 
Clifton, NJ 07011-2252 USA 
Voice: 201-478-1970 

Fax: 201-478-1513 
Easy on your wallet AppleLink: 01922 
Compuserve: 70731,2326 


DragInstall’s one-time fee of only $300.00 allows you to distribute an unlimited Internet: sauers@aol.com 


number of installers. No yearly renewals, no royalties, no hassle! 





Mac Source Code CD-ROM 


New Release 2! Over 600 megabytes of up-to-date Mac-only 
source code and programmer utilities. Most of the source code is 
in CodeWarrior, Symantec, and MPW projects for C, C++, and 
Pascal. Includes complete working examples of applications, 
games, control panels, extensions, utilities, and much more! $35 
including shipping. Add $5 for shipping outside of the U.S. and 
Canada. VISA, MC, American Express, and Discover gladly 
accepted. _ 


i ) : . fila Se — 
Celestin Company, 1152 Hastings Ave, Port Townsend, WA 98368 
800 835 5514 © 360 385 3767 © 360 385 3586 fax 
Internet: celestin@olympus.net ¢ CompuServe: 71630,650 


DEVELOPER 








For more information, contact the Apple Developer University Registrar 
by telephone at (408) 974-4897 or fax (408) 974-0544. 


Developer University, Apple Computer, Inc. 1 Infinite Loop, MS 305-1TU, Cupertino, CA 95014 
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Best booth? It had to be Bungie’s booth. It’s not that the 
booth itself was anything special. In fact, I can’t say that I ever 
saw the booth because you couldn’t get near it even by waving 
cash at them. People were crowded around five deep trying to 
buy Marathon. 


Worst booth? It’s so hard to choose...but we'll give it to 
Pinnacle. Their steel box fortress may make for some nice, 
quiet conversations on the inside, but who found the door? 


Most overly-hyped party? Could it be the Be In? Best 
happening at the Be In? Cool General Magic demos. Did you 
know that those things can send e-mail? 


Who was showing at Developer Central? Hang on to your hats! 


Absoft — MacFortran, C++ 

ACI — 4th Dimension and 4D Server, Object Master 

Aladdin Systems — StuffIt InstallerMaker 

Apple Computer, Inc. - APDA, Apple Dylan, Apple Guide 
Authoring, Apple Media Tool, Developer Press, Developer 
Support Programs, Developer University, 
HyperCard/AppleScript, Mac OS SDK, MPW Pro / E.T.O., 
Multimedia Development Tools, Newton Toolkit, OpenDoc, 
QuickTime 

BareBones Software— BBEdit 3.1, PopupFuncs 2.5, Cool T-Shirts 

Bowers Development — AppMaker 

Claris Corporation — FileMaker Pro, FileMaker Pro Server and 
Runtime. Claris Solutions Alliance 

Digitool, Inc. — Macintosh Common Lisp 

dtF Americas, Inc — dtF Relational Database 

EveryWare Development Corp. — Butler SQL Server 

Graphical Business Interfaces Inc. — Tablelt!, Cataloger™ and 
Template Constructor™ 

Hayden Books — Programming Books 

Jasik Designs — The Debugger/MacNosy 

Kaleida Labs, Inc. — ScriptX 

Language Systems — LS Pascal and LS Fortran 

MacTech Magazine — MacTech CD, MacTech Mail Order 

Main Event Software — Scripter®, Rosanne™ Data Processing 
Package. 

Mathemeesthetics, Inc. — Resorcerer 

Metrowerks — CodeWarrior 5 

Micro Macro — MicroGuard 

Microsoft Corporation — FoxPro, Visual C++ 2.0 Cross- 
Development Edition 

Motorola 

PACE Anti-Piracy — PACE Anti-Piracy 

Prograph International — Prograph CPX 1.1, Prograph 
Client/Server Tools, Prograph Classic 

Quasar Knowledge Systems — SmalltalkAgents 2.0 

Remote Measurement Systems — EnviroMac 

SAS Institute — SAS: JMP 

Scientific Placement — Recruitment services for professional 
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SOFTWARE FOR SALE? 
NO ADVERTISING BUDGET? 


Try listing your product in MacTech Magazine’s Mail Order Store. 
Classified advertising at a cost effective rate. 


For more information, call: 

Voice: 310/575-4343 e¢ Fax: 310/575-0925 

AppleLink, GEnie & America Online: MACTECHMAG 
CompuServe: 71333,10604 ¢ Internet: marketing@xplain.com 


MaclechMacazine’ 


FOR MACINTOSH PROGRAMMERS & DEVELOPERS 


Macintosh Software Developers. Waterloo Maple Software — Maple V, Theorist, Expressionist, 
Stone Tablet Publishing — StoneTable MicroExpressionist, MathEdge. 
Summit Software Company — BasicScript™ Toolkit for 

Macintosh ...and hiding off on the edge, as if they were really a part of 
Symantec Corporation — Symantec Developers Advantage, | Developer Central, was Dell, surrounded by sand bags and 

Symantec C++ 8.0 for Power Macintosh signs saying, “Don’t shoot! We're not the enemy.” Right. 


Tenon Intersystems — Tenon’s Unix/Mach software, MachTen 
True BASIC, Inc. — True BASIC 











Dilbert® by Scott Adams 


MY MARKET RESEARCH 
INDICATES THAT 50% 
OF YOUR CUSTOMERS 
ARE ABOVE THE 
MEDIAN AGE. 


LIHAT PERCENT 
ARE EXACTLY 
THE MEDIAN 
AGE? 


BUT THE SHOCKING 
DISCOVERY WAS 
THAT 50% WERE 
BELOW THE MEDIAN 
AGE. 


I'M PROPOSING 


TO STUDY THAT 
IN PHASE TWO. 


ScottAdams @AOL.com 





© 1994 United Feature Syndicate, Inc. 


5S. Adams 





reprinted by permission of UFS, Inc. 
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Pascal — C++ 


Stuck with Pascal source code? 
Want to move to C++? 


OP2CPlus is a Macintosh tool for converting 
Object Pascal source code to C++ source code. It 
has already been used to translate hundreds of 
thousands of lines of Object Pascal to C++. 


Ease your transition to OpenDoc or PowerPC 


) Convert in days instead of months 
LJ Generates C++ classes 
LO) Works with MacApp 2 or 3 
) Translates Think or MPW Pascal 
QO) Full ANSI C source code included 
O) Just $895 

Graphic Magic Inc, 180 Seventh Ave, Suite 201 


Santa Cruz CA 95062 Tel (408) 464 1949 
Fax (408) 464 0731 AppleLink GRAPHICMAGIC 





Can you spot 
the difference’? 


Plenty of people can’t. Because whether you update software with a full 
set of program disks, or a file made with UpdateMaker 2, the result is 
the same. Guaranteed.UpdateMaker updates are totally reliable. 

Its system of 32-bit checksums ensures that it updates the right file. 


And UpdateMaker is easy-to-use - simply specify the files and 
UpdateMaker builds the update. There is no scripting or use of 
ResEdit. It’s even easier for end-users — just one button to press. 


UpdateMaker 2 works with any type of Macintosh file. The updater 
files are extremely Compact. And the program options numerous. 
You can preserve or override user customisations. Save files in Binhex 
format. Update up to 20 old versions with one file. 


The real difference is the savings in time and money. Which explains 
why some of the best-known names in software development have 
already discovered UpdateMaker 2. 





Distribution is unrestricted and royalty-free. 


Only $225, order now (415) 964 2878 


or Applelink:MacLab007 


UpdateMaker 2 


ADInstruments, 2225 Grant Road, Suite #4, Los Altos, CA 94024 Fax: (415) 964 2886 
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Get Your Name “In Lights” 


Have you ever thought about writing an article? The 
editorial staff at MacTech Magazine would like to personally 
invite you to write for the publication. While writing an 
article is not difficult, it does take a bit of time. But, you get 
to share your knowledge with the community, see your 
names “in lights”, and ... you get paid for your efforts! 

To get started, you can download the MacTech 
Writer’s Kit from one our online support areas. Here 
you will find information on how to submit an article — 
and it comes with examples, templates and style sheets. 
Feel free to e-mail us with questions. 


Call for Articles 


Many of you have asked “what topics would we 
like to see?” Recently, our Editor, Scott T Boyd, 
provided us with insight as to what he’d like the 
magazine to cover in 1995. Our goal at the magazine is 
to publish articles on diverse topics that are sure to 
keep our readers both interested and well-informed 
throughout the year. If you’d like to be part of this 
group, think about what you know about — that’s what 
we'll be most interested in. As a guideline, you can 
think about one of the following issues. 

For example, topics that include articles that teach 
debugging techniques and advocate good debugging tools. 
This continues a recent theme about making software more 
reliable. We will continue to talk about “cool” Apple 
technology such as Threads and Drag and Drop; or as Scott 
said, “software that takes us out of the Stone Age.” 

There will be tips on how to get your business on 
the Internet and how business models are shaping up. 
More heavy-hitting deep technology articles will be 
included, such as the recent September article on 
emulator technology and the two-part article on 
PowerPC Architecture. We'll see continued coverage on 
the developments in OpenDoc and OLE technologies, as 
those on the sidelines start choosing up sides or 
deciding not to play. 

MacTCP is another area of importance, as more 
people get excited about providing Macintosh-quality 
software for Internet users. You will see additional 
coverage on Visual Programming. You should also 
expect to see more on cross platform development. And, 
even though it’s a moving target, we will be covering 
Apple’s next System Software release — Copland. 


E-mail us with your idea and let’s talk. You never 
know, you might get your name “in lights”! 
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The Editor's Page continued from page 4 | —— — om 
protection is in place. Ever see a unix kernel crash? I have. 4 — ae O TON: S WwW WANTED _ 


Ever see the Power Macintosh memory-protected nanokernel "536.3577 
/ 1-800-73 
crash? I have (three times yesterday, and twice today, Available Immediately 


unfortunately). Computers are complicated beasts, and it’s Exp ert AD Programmers 
extremely tough to cover all the possibilities, memory Less than 50¢ per hour! 


protection notwithstanding. 
Will memory protection protect against someone writing to More than 1,000 hours of develo eae $395.07 
the system file directly? Nope. How about protecting against AD Toolkit 20. Lae ae programmers at 
someone adding or changing resources in the system file? it’s like ae ee Call 1-800-736-3577 to 
Again, nope. Is it possible to protect the system file? Sure. pea 2 : or to receive a free demo. 
One example is the Macintosh Classic, which can boot from erat ae 
ROM (just try to change that system file!). By the same token, 
anything that is protected by a software mechanism, yet offers 
an API for writing, opens up the possibility that someone may 
use it incorrectly. This same reasoning covers what happens 
with PRAM. It’s generally pretty difficult to write to PRAM 
without using the API. Yet we still see situations where the 


pment went into 


4DTOOLKIT” 


PRAM (or the CUDA, which handles serial on the AVs) gets OPtions Computer Consulting 
; t] fi d B i ole: de? B in, 39d 228 Bleecker Street #19 
incorrectly configured. Bugs in Apple's code? Bugs in 3r New York, NY 10014 
party code? Sure. Will protection help? Not really. TEL: 212-645-3577 

What’s the solution? Modernization, certainly. Memory FAX: 212-633-0336 
protection is a good thing (holy grails are nice to have), but it’s * upgrade pricing available 


going to be a while yet. And keep in mind what it’s supposed 
to protect against — flawed software that goes astray. And who 
writes it? We all do! It’s time that we learn what mistakes we’re 
making, and then teach each other about them, and then devise 
methods to avoid them 


, AA 
Finally, Apple could help out with overhauled and/or new Relational Database C/C++ Class Libraries 


APIs which help us avoid common pitfalls. Such APIs could E d T T 
help by making errors harder to make (reducing the error n oOo yran ny 
modes), and by offering services so we can stop writing some 
of the same old code for the umpteenth time. And how about 

fer eau i d d f h 4 eaitevat Free yourself from the tyranny of complex database "solutions" 
olering only the calls we need, and not a few thousand calls 0 and take back the control you need to complete your product on 
everything you could ever think of? time and on budget. 


On-Time, On-Budget Product Development 


Our multiplatform relational database class library, RC/21, 


ON A SLIGHTLY DIFFERENT TOPIC... offers astonishingly straightforward development discipline with 


extraordinary features not found in any other commercial database 
So you want to start a company and you're sweating it out at ; : 
y ies y 8 product. License fees are reasonable and affordable. Rational 


yOUr “real” job while developing so killer idea? Maybe class design plus source availability provide flexibility and ample 
you've taken the big step and gone out on your own to bring opportunity for customization. ODBC support leverages your 
the killer idea to market. Maybe, just maybe, it looks almost development with numerous3rd-party end-user tools. We offer 
like a product. Now what do you do? Why marketing, of toll-free product support and custom development by theRC/21 
ae 4 developers. 

course! And how better to start than by building a “presence”? Call 1-800-822-4437 To Ord 
Not every upstart could pull it off, but the odd assortment of oa ah Sik el Oo EGE 
Collaboration Technologies, Mark/Space Softworks, MacUp, > $149 full-featured Developer's Kit (single-CPU) 
Mac the Knife, and even Apple filled Bondage A Go Go > oe Lenihan Saab 

F P : > istribution License Pac 
with wide-eyed MacWorld show-goers to mingle and 5 $49 SpuC Dave 
gawk at people in black/leather/fetish attire. As with S $Call Client/Server Kits 
many marketing efforts, it’s hard to know whether Get C | Now! 
Mac Black ’95 achieved the desired effect, but no et Contro Ow: 


doubt remains about whether the attendees will remember it! ermont 400 Upper Hollow Hill Road 
Stowe, VT 05672-4510 USA 


Database |-802-253-4437 
Cotporation 1-802-253-4146 FAX 


70334.3705@compuserve.com 


Put Us On Your Team! 








Foop For THOUGHT 
Have Net, will travel! — Brad Kollmyer 





MarcH 1995 @© MACTECHMAGAZINE THE EDITOR’S PAGE 63 








By Scott T Boyd, Editor 








CHALLENGING CHALLENGE CHALLENGED 
One of the Huffman challenge entrants, Allen Stenger, found a 
bug in Bob Boonstra’s winning published Huffman code. It’s 
minor (ushort should be ulong) but it’s a real bug. Fixing it 
doesn’t change Bob’s speed. Here’s some background on the 
problem. 
— Mike Scanlin 

progchallenge@xplain.com 
Allen writes: 
Subj: Huffman solution error? 

I believe I’ve found an error in Bob Boonstra’s published 
solution to the Huffman challenge (MacTech, January 1995 
issue). Look at p. 72, the definition of macro 
ProcessBitSlow. Observe that temp is declared as 
register ushort; contrast this with the immediately 
preceding macros ProcessBit and ProcessBitFast, where 
it is defined as register ulong. Actually all three should be 
ulong. The reason is that temp is the offset to the child node; 
since the node table could be as large as 256K bytes (64K 
nodes), temp can hold the offset in units of nodes but when 
ProcessBitSlow does the multiplication temp *= 
sizeof (DecodeNode), temp may overflow. 

I was able to provoke this failure using the following 
example: The decoded numbers are either 3-bit numbers 0-7 or 
16 bits numbers 8000-FFFF. The 3-bit numbers are encoded in 
4 bits as 0-7 (i.e., a leading 0 bit followed by the number). The 
16 bit numbers are encoded as themselves (they already have a 
leading 1 bit). Under this scheme A000 is decoded incorrectly. 

— Allen Stenger 
Bob replies: 

Allen Stenger is correct in pointing out an error in the 
published solution for the HuffmanDecode challenge. As Allen 
points out, the declaration of the variable temp in macro 
ProcessBitSlow should be register ulong. 

The bug shows up when both of the following are true: (1) 
the private storage available exceeds 64K, AND (2) 
numSymElems is large, greater than ~8K to ~32K, depending 
on maxMemoryUsage. 

The bug does not occur if maxMemoryUsage is <=64K. 
Condition (2) for the bug is really when the size of the decode 
table exceeds the available storage. Since each node in the 
decode table is 4 bytes, and since there are (roughly) 2 nodes in 
the decode table for each element of the symbol table, the bug 
shows up under the following conditions: 


numSymElems maxMemoryUsage 


> ~8K > 64K 
>~16K >128K 
>~32K >256K (beyond Challenge limits) 
max (2**16-1) >512K (beyond Challenge limits) 


(The relationship to numSymElems is approximate because it 
depends on the degree of balance in the tree representing the 
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Huffman encoding.) 

In these cases, some symbols will be decoded incorrectly. 
In the case cited by Allen, numSymElems is >32K, and the 
error shows up if maxMemoryUsage is >64K. 

Correcting the bug changes a few xxx.W instructions to 
xxx.L, but shortens the code generated by the macro in 
question by one instruction, and actually improves the run time 
by an almost imperceptible amount. 

It just goes to show you can’t do enough testing. My 
testing used Huffman encodings that were generated from large 
text files, so I got encodings with a few thousand elements. 
Still, I should have caught this one by inspection. 
Congratulations to Allen for detecting the error, and good luck 
to him in future Challenges. 

— Bob Boonstra 





ANONYMOUSLY YOURS 
I've heard that it’s possible to anonymously send e-mail to 
someone. I’ve also heard that in order for this to be really 
anonymous you need to send it through three or four 
anonymous re-mailers. Could you publish the addresses of 
these remailers and give an example of how to send e-mail that 
has a very high chance of remaining anonymous? 


[name and address withheld] 





GREAT PROGRAPH COVERAGE 

Your January ’95 issue looks like one of the best ever. Two CD- 
ROMs, who could ask for more? I was also very excited to see 
Kurt Schmucker’s article on Prograph Commands. I hope that 
these articles on Prograph become a regular feature. As a 
former member of the Software Frameworks Association, I’m 
glad to see MacTech really taking up the slack where 
Frameworks left off. I have been working with Prograph CPX 

for several months now and find it to be a great tool. 
Please keep up your coverage of it, and other new OOP 

technologies. 

— Steve Wilson , Emergent Behavior 
emergent@aol.com 





Do THE COBBLER’S CHILDREN ALWAYS GO BAREFOOT? 
I am inspired to write after reading the letter by Steve Weller, “A 
Trail of Good Intentions”, printed in the December Dialog Box. 
Like Steve, I always thought that “C” stood for cryptic but C++ is 
much worse. 

I can best describe myself as a classic Mac hacker, that 
is one who programs the Mac for the sheer joy of it and not 


Continued on page 69 
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By Scott T Boyd and John Kawakami 








fj there’s something you'd like to see here, please drop us a 
note at editorial@xplain.com. 
In case you're not familiar with Uniform Resource Locator 
(URL) format, it’s essentially 
<servicekind>://<servername>/<pathname> 
That’s a bit of an oversimplification (e.g. the path can be far 
more interesting), but it should be enough to you started. 


What’s New and Interesting? 
In case you haven’t heard, Apple has been updating and 
improving their WWW and ftp servers. It’s difficult to describe 
the many megabytes of information Apple has made available: 
selected DocViewer versions of Inside Macintosh, a demo of a 
Developer University course, source code, and a ton more stuff. 
Perhaps this is a ploy to convince you to order the APDA CDs. 
ftp.info.apple.com and http://www.info.apple.com/dev 

MIDnet’s Info-Mac searcher helps you search the contents 
of the vast Info-Mac software archive by name, title, or 
keyword. You can read the file’s long description before 
downloading. Elegant. http://www.mid.net/INFO-MAC 

There’s a new Macintosh programming ‘zine available. It's called 
Get Resource and is at http:/Awww.asel.udel.edu/~haynes/g1r.html 


Places with Many Macintosh Developer Links 
The URLs listed below are the best places to hunt down new 
developer info, third party products, etc. They are maintained by 
the unsung heros of the Internet — dedicated volunteers. 
Robert Lentz may have the most hyperlinked Macintosh 
developer page at 
http://www.astro.nwu.edu/lentz/mac/programming/home-prog.html 
Nick.C DiMello has another well linked site, 
http://www. pitt.edu/~nick/ 
Paul Robichaux’s pointers to misc Macintosh and ‘net issues. 
http://www.iquest.com/~fairgate 
Eric Scouten has info on TCP programming, and other links. 
http://tampico.cso.uiuc.edu/~scouten/ 
The Macintosh Vendor Directory has vendor contact info 
http://rever.nmsu.edu/~elharo/faq/vendor.html 
Matthias Neeracher features many pointers to source code on 
the net. Also a fancy TCP class 
http://err.ethz.ch/members/neeri.html 
MacTech’s URLs (this column) is now hypertextified, thanks to 
Jim Straus at class.com 
http://www.class.com/MacTech/URLs.html 
World Wide Web progamming info 
http://Awww.uwtc.washington.edu/Computing/WWW/ExtendingMacHTTP. html 
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Interesting Macintosh Places 


Alpha ftp://cs.rice.edu/public/Alpha/ 

Apple ftp://ftp.info.apple.com 

see also http://www.info.apple.com/dev 

see also http://www.austin.apple.com 

Applescript ftp://gaea.kgs.ukans.edu/applescript 

BBEdit ftp://ftp.netcom.com/pub/bb/bbsw 

Celestin ftp://ftp.teleport.com/vendors/cci/apprentice 


Contains a file with the contents of the CD 
Dylan http://www.cambridge.apple.com/ 


see also ftp://cambridge.apple.com/pub/dylan 
see also http://legend.gwydion.cs.cmu.edu:8001/dylan 
see also news://comp.lang.dylan 

Get1 Resource http://www.asel.udel.edu/~haynes/g1r.html 


Info-Mac searcher http://www.mid.net/INFO-MAC 
Internet Config _ ftp://ftp.share.com/internet-configuration/ 
Peter Lewis ftp://amug.org/pub/peterlewis 
Mr. Lewis is the wizard of MacTCP Apps 
Lisp http://www.cambridge.apple.com/mcel/mcl.html 


see also http://www.cs.rochester.edu/u/miller/alu.html 
Mac Netswitch __ http://www.nd.edu/~dwalton1/ 
MacNosy ftp://ftp.netcom.com/pub/ma/macnosy 


MacTechMagazine ftp://ftp.netcom.com/pub/xp/xplain 
Metrowerks http://www.iquest.com/~fairgate/cw/cw.html 
OpenDoc ftp://cil.org/pub/cilabs 
Francois Pottier 
http://acacia.ens.fr:8080/home/pottier/index.html 
Mr. Pottier is the editor of the comp.sys.mac.programmer Digest 


see also news://comp.sys.mac.digest 
OKS/Smalltalk — http://www.qks.com 
QuickCam 


http://www.engin.umich.edu/~friscolr/QuickCamtm/readme.html 
Symantec 
ftp://devtools.symantec.com/Macintosh/Updaters/DevTools 
TCL stuff ftp://daemon.ncsa.uiuc.edu/TCL 
TidBITS http://www.dartmouth.edu/pages/TidBITS/TidBITS. html 
see also news://comp.sys.mac.digest 
Time Tracker ftp://ftp.maui.com/pub/mauisw 


Interesting non-Macintosh Places 

You can read about and view photos of old, obsolete computers 

like the ENIAC, the BBN, and the Sun 3, at the California 

Historial Computer Society’s gopher: 
gopher://gopher.vortex.com/11/comp-hist. 

Dilbert, everyone’s favorite comic strip: 
http://gnn.interpath.net/gnn/arcade/comix/graphics/Dilbert.gif 
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INSIDE INFO 


By Chris Espinosa, Apple Computer, MacTech Magazine Regular Contributor 











The Platform Problem 





INSIDE INFO 


Going cross-platform for 
the wired generation 


Listening to Microsoft pitch their 
cross-development environment for 
Macintosh reminds me that I’ve been 
working on solving the platform 
problem for over three years now. 

In case you joined late, the 
“platform problem” is the dilemma that 
an industry faces when there’s one 
dominant standard, and a number of 
minority players who can’t unseat the 
dominant player because of the huge 
infrastructure supporting the standard. 
Having more than one platform makes it 
look like things are competitive, but the 
reality is that the minor players really 
don’t have a chance to gain on the 
dominant standard in the markets it 
dominates. 

Intel vs. everyone else is a good 
current example; so is Windows vs. 
OS/2, Mac, UNIX, Novell, NextStep, etc. 
The dilemma I face is how to help 
developers continue to make superior 
products for the Mac OS, even though 
the customers and the industry 
infrastructure favor the Windows 
platform. 

And you’ve seen a lot of attempts 
by Apple to solve this. Against DOS, it 
was less of a problem, because there 
were so many things in the Mac OS that 
just didn’t exist on the DOS side. With 
Windows, that differentiation is small 
enough that many customers perceive 
that the Mac’s difference is a liability, 
not an asset. So to bridge the gap 


between Mac and Windows, we've tried running the Windows 
OS on Mac hardware; porting the Mac OS to Intel hardware; 
writing a new cross-platform OS from scratch (Taligent 
CommonPoint); creating a complete application framework to 
encourage cross-platform applications (Bedrock); creating a 
cross-platform component application technology (OpenDoc); 
doing a cross-platform framework for OpenDoc (OPF); 
building cross-platform APIs (QuickTime) and media playback 
platforms (Kaleida Media Player); and the current favorite, 
licensing the Mac OS to clonemakers to expand the Mac OS 
market share. We’ve done these alone, with partners, and 
through joint ventures. Some we've shipped; others were killed 
before they got too expensive. (And a couple just got too 
expensive without being killed!). 

Through all of this, Apple’s OS market share has remained 
at pretty much exactly what it was in 1983, after the ascendancy 
of the IBM PC and the beginning of the IBM clone market. 
Maybe cloning will change that (after all, so many smart people 
told us to do it ten years ago that they must be right!). But 
maybe there is something else that will change the rules and 
make this API war irrelevant. 

Think about what we would like to be able to do. Write 
something once and deploy it on many platforms. Have a 
common programmatic interface, but take advantage of the 
native user interface of each machine. Integrate smoothly with 
the underlying OS. Be lightweight. Be accepted as a common 
industry standard, neither monopolized by a single company 
nor designed by a committee. Support all of the cool new 
technologies, like multimedia and networking. And be quick 
about it - we can’t wait until 1997 to have it running. 

Well, there may be an answer: the World Wide Web. 

I’ve been cruising the Web recently, and I think it’s 
remarkable how platform-neutral it is. By reading the file 
names in the HTML source code you can see which hosts are 
on a Windows OS, which are on UNIX, and which Mac; and it’s 
clear from the credits on some home pages that a tremendous 
variety of Sun, HP, IBM, SGI, DEC, Dell, Compaq, Apple, and 
other equipment is being used as hosts. The Web is an 
incredibly huge heterogeneous environment running a single 
application that looks the same to the end user, regardless of 
the combination of client and host. 
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This may be the great equalizer that renders the API wars 
obsolete. Already I can see a large number of applications that 
I use in my work life that could be implemented as a 
combination of FTP, Gopher, Archie, and WAIS services, front- 
ended by a home page. I’ve seen Web pages that are very nice 
forms-based front ends to Oracle, DB/2, and Sybase databases. 
When I use these pages it’s clear to me that they are fulfilling 
my cardinal rule of computing: they’re helping me get my work 
done without my noticing what technologies are being 
employed to do it. 

It is said that on the Internet, nobody knows you're a dog; 
well, nobody knows you're a Performa, or an Indy, or a Presario 
either. This is crucially important. Microsoft made Windows a 
phenomenon by changing the definition of what constituted 
compatibility with the industry standard. Before 1992, being a 
clone of the IBM PC AT defined compatibility; after 1992, 
running Windows did. If in 1995 the definition of compatibility 
is “can browse the Web,” a huge emotional weight will have 
been lifted from the personal computer industry. The Mac can 
be industry-standard-compatible without running Windows! 

Of course HTML and WAIS and Gopher aren’t an API. Can 
they grow to be one? Perhaps. Is the growth process in 
reasonable, safe hands? I trust the people who built the 
Internet more than I trust the people who built the Pentium. 
Can the Web software form a solid layer of abstraction that 
masks underlying differences in OS and hardware? For many 
applications, yes. For all? Of course not. 

Nothing will ever eliminate the differences in processor 
opcodes, system calls, and implementation details that make 
cross-platform programming such a pain. Programmers get 
paid to bridge those differences elegantly. The point of the 
Web becoming the next platform is that the popular mind will 
be saved from having to worry that those differences make a 
difference. The fear of buying a minority standard will be 
greatly decreased if all computers are assured a high level of 
basic functionality and interoperability through the Web. Then 
we can let Mac be Mac, Windows be Windows, and turn Mac 
vs. Windows from a worldwide religious feud back into a 
‘ simple design preference among engineers. 










DID YOU KNOW?? 


If you have a CD ROM 
you can have all of MacTutor 
since 1984 on line? 

See The Mail Order Store on page 73 
for more info. 
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Tips & Tidbits continued from page 80 


Hot Tip For Hot Keys 

One of the things I appreciate in applications is the ability to select 
buttons with keystrokes (the keyboard shortcut is known as a 
hotkey). The following code example adds hotkey functionality to 
alert dialogs and can be easily added to modal dialogs. The next 
time you use an alert, add AlertKeyProc to the function and you 
will have instant hotkey functionality. Simply change 

CautionAlert(ALERT_ID, NIL) 
to 

CautionAlert (SAVE_ALERT_ID, AlertKeyProc) 


#include <Dialogs.h> 


#define kEnterKey 3 
#define kReturnKey 13 
#define kEscapeKey 27 


pascal Boolean AlertKeyProc(DialogPtr theDialog, 


EventRecord *e, short *itemHit) 


f 
l 


char theChar:; 

short num, i, iType; 
Handle iHandle; 

Rect iRect; 

StrZ) iText; 

long finalTicks; 


switch( e->what ) 
{ 
case keyDown: 
case autokey: 
theChar = (e->message & charCodeMask) ; 
if(theChar == kReturnKey || theChar == kEnterKey) 
{ 
*itemHit = 1; 
return( TRUE ); 
} 
else if(theChar == kEscapeKey) 
{ 
*itemhit = 2; 
return( TRUE ); 
} 
else 
{ 
num = CountDITL( theDialog ); 
for (i=0; i<num; i++) 
{ 

GetDItem(theDialog, i, &iType, &iHandle, &iRect); 

if(iType == ctrlItem + btnCtr1l) 
{// If the button is a push button 
GetCTitle((ControlHandle )iHandle, iText); 
if(theChar == iText[1] || 
theChar == tolower(iText[1])) 

{ 
ra Vem t= 15 
HiliteControl((ControlHandle )iHandle, 1); 
return( TRUE ); 


} 
} 
break; 
} 
return( FALSE ):; 


- Jeff Beeghly, jbeeghly@u.washington.edu 
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By Scott T Boyd, Editor 


Doc BITES CODE 


Barking Dog Software Co., a developer of Macintosh software 
development tools, is now shipping “Call Tree” for both 
PowerMac and 68k Macintosh systems. 

“Call Tree” is a stand-alone C source code analysis tool 
which automatically produces a function call tree. This call tree 
allows programmers to quickly understand the design and 
calling structure of simple or highly complex programs. Many 
applications are composed of thousands of functions and 
hundreds of files and understanding such code structure 
without an automated tool like “Call Tree” is so time consuming 
as to be impractical. However, “Call Tree”, which utilizes Drag 
& Drop functionality, produces its analysis by processing 
thousands of lines of C source code per second. The results 
may be saved or printed. “Call Tree” results are also useful for: 
e Understanding weak or invisible modularity which may be 

exploited to increase code portability and reduce 
maintenance costs. 

e Assist in optimizing, through a quick and more detailed 
understanding of function traversal and possible 
rearrangement of modules for efficiency. 

e Tracking intentional (or unintentional) changes in program 
design and modularity in order to prevent accidental 
design shifts. 

As such, “Call Tree” is valuable for both programmers and 

technical managers. 

“Call Tree” is compatible with source files for CodeWarrior, 
MPW, Symantec and any other standard C formatted text files. 
“Call Tree” does not require MPW, a development environment 
or a compiler to operate and may be employed to analyze 
code for Windows as well as Macintosh. “Call Tree” is shipped 
as a fully functional, stand-alone tool with native versions for 
68k and PowerMac machines. 

“Call Tree” is designed to do one function well, be simple 
to use, and require virtually no time to install and learn; yet 
produce results which save hundreds of hours and provide 
information for better source code control and understanding. 


“Call Tree” is available immediately and sells for US$149. 
Barking Dog Software Co., 4822 Santa Monica Ave., Suite 179, San Diego, CA 92107. 
(619) 222-8361 or calltree@aol.com. 





New NEWTON TOOLS 
Creative Digital Systems, publisher of PDA Developers 
magazine and several Newton developer tools, announces the 
availability of developer toolkits for creating Macintosh and 
DOS desktop applications that can communicate with Newton 
MessagePads using wireless infrared connections. 
Applications built with these toolkits require that the desktop 
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system have an IR transceiver such as a Sharp Electronics CE- 
IR2 or CE-IR3 attached to a serial port on the desktop system. 

The Macintosh toolkit, called GizmoBeam™, is a Macintosh 
device driver that implements Apple Computer’s superset of the 
Sharp infrared data transfer protocol that is embedded in the 
ROM of every Newton device. GizmoBeam includes the driver 
resources and Think C 7.0 sample code. A programmer should 
have some understanding of Macintosh device drivers and the 
Device Manager in order to use GizmoBeam effectively. 

The DOS toolkit, called MicroWave™, implements the 
Sharp infrared data transfer protocol, a Newton-compatible 
subset of Apple’s full Newton infrared protocol. It comes as 
both Borland and Microsoft-compatible linkable libraries. 
MicroWave has a straightforward interface that can be used by 
anyone familiar with C programming. 

GizmoBeam and MicroWave are $250 for a single-seat SDK 
and five-user distribution license for a single product, with an 
additional $25 discount when both kits are purchased. Both 
have additional licensing fees for corporate and commercial 
distribution of products incorporating their code. A 500-unit 
distribution license for a single product is $1000; an unlimited 


single-product distribution license is $2000. 
Creative Digital Systems, 293 Corbett Ave, San Francisco, CA 94114. (415) 621-4252 
voice, (415) 621-4922 fax, e-mail cds@netcom.com 





WHAT’S NEW IN CODEWARRIOR 5? 


The following are a few new features in CodeWarrior 5: 

- MPW tools for 68K and PowerPC 

- Templates 

- Global Optimizer 

Conditional breakpoints/expression evaluation in debugger 
The Metrowerks CodeWarrior Volume Purchase Discount 

Program for commercial use will end. Existing site license 

agreements will continue. Metrowerks will convert to broad 

distribution and volume purchases will be processed by the 


distribution channel. 

Look for information on the CodeWarrior 5 release on AOL, AppleLink, eWorld, 
Compuserve, GEnie, WWW at Fairgate and Comp.sys.mac.programmer.codewarrior on 
the net. For more information contact: sales@metrowerks.com 





APPRENTICE 2.0 — 600 MB For $35 
Celestin Company announces Apprentice release 2, an attractively 
priced CD-ROM compilation of Mac source code and utilities. 
Many Macintosh programmers have been frustrated by the lack of 
an inexpensive collection of sample source code. The few 
collections that are available are not only out of the price range of 
many people, but contain outdated examples that may no longer 
demonstrate effective programming techniques. Apprentice 
contains programmer utilities and up-to-date source code in 
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Newsbits continued from page 08 


CodeWarrior, Symantec, and MPW projects for C, C++, and Pascal. 

In order to compile such an exhaustive collection of quality 
source code, Celestin Company contacted over 200 Macintosh 
developers and received their permission to include some of the 
best programming examples available. Users will find complete 
working examples of applications, games, control panels, 
extensions, utilities, and much more. 

Those new to Mac programming will find the included 
“frameworks” very useful. These are complete application shells 
that take care of many of the tedious tasks associated with Mac 
programming including menus, standard dialogs, file handling, and 
the like. A complete Mac application can be built in no time, by 
simply providing the code to perform specific activities. All other 
aspects of the Mac environment are handled by the shell utilities. 

Apprentice contains dozens of libraries and classes 
(including a complete suite of Think Class Libraries), from 
graphics and sounds to menu management and serial 
communications. Many of these libraries include complete 
source code. Also included are hundreds of code “snippets”, 
small routines that perform specific programming tasks. From 
displaying a color icon or resolving a file name alias, developers 
will find what they are looking for in this definitive collection. 

Apprentice contains more than 20 complete standalone 
programming environments. Ada, C, Forth, Lisp, Modula-2, Oberon, 
and Prolog are only a few of the languages included. Most come 
with complete documentation and programming examples, and 
some include complete source code to the language itself. 

The information hungry will find technical specifications, 
language guidelines, programming hints, as well as a complete 
collection of the comp.sys.mac.programmer digest, a 
compendium of information from one of the best Mac 
programmer discussion groups on the electronic networks. Also 
included are demonstration versions of commercial programmer 
utilities, including installers, code and resource editors, database 
libraries, and much more. 

Everything on the disc is indexed using several different 
utilities, so users will find what they are looking for quickly and 
easily. A text-only version of this index is available via 
anonymous ftp from the following site: 
ftp://ftp.teleport.com/vendors/cci/apprentice/apprentice.hqx 

Apprentice is $35, which includes standard shipping within the 
United States and Canada. It comes with an unconditional 30-day 
money-back guarantee, and customers who for any reason are 


dissatisfied with their purchase, are entitled to an immediate refund. 
For more information about Celestin Company and its products, call (660) 385-3767 
voice, (360) 385-3586 fax, or email celestin@olympus.net 





NEWTON TECHNOLOGY JOURNAL 


Xplain Corporation, the publisher of MacTech magazine 
announced today that it is working with Apple Computer, Inc. to 
produce the Newton® Technology Journal™., As a central piece of the 
Newton monthly mailing, the Newton Technology Journal was created 
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to disseminate information to Newton developers in the range of 
Developer Programs introduced by Apple in December 1994. 

The Newton Technology Journal is a bi-monthly publication 
tailored specifically to the Newton platform developer. The Newton 
Technology Journal is the primary resource for the latest information 
on Newton platform technology, Newton development tools, PDA 
business, and market news from Apple and its Newton licensees. In 
addition to the technical information, the Newton Technology Journal 
will also provide developers with a well-rounded picture of the 
opportunities that the Newton platform is building for developers. 

The Newton Technology Journal, produced and edited by Xplain 
Corporation, benefits from Xplain’s experience in producing technical 
publications since 1984. The publication is a no-nonsense, easy to 
read publication that caters to the readers’ information needs. The 
journal’s Managing Editor is Lee Dorsey of Apple’s PIE division. The 
articles are authored by Newton engineers and other Newton 


business and technology experts from inside and outside of Apple. 
For more information on the Newton Technology Journal or the Newton Developer 
Programs, contact: Apple’s Developer Support Center at 408-974-4897 or 
devsupport@applelink.apple.com 





Dialog Box continued from page 64 


to make a living. As a programmer, my user interface is the 
editor I use. I have made a few dollars on shareware but 
mostly I program the Mac just because I love the Mac’s user 
interface. | 

You can judge the low quality of the editors that come with 
most C++ compilers by the number of third party editors being 
sold. I personally can’t stand to use any of the popular C++ 
environments (with or without third party editors) because they 
don’t just compare to the editor in THINK Pascal. 

THINK Pascal’s editor automatically formats my source 
code. It finds syntax errors before I waste time trying to 
compile. Most of the Mac user interface is in the Runtime and 
Interface libraries so I seldom have to include other libraries or 
interfaces. The stops are easier and quicker to use than the ones 
in C++. Best of all, the compiler and linker are very fast for 
reasonable sized programs. 

The only thing I have found that really slows THINK Pascal 
is when I play with MacApp, TCL or one of the other bloated 
object libraries. For my serious programs I use THINK Pascal 
with a non-object shell generated by Marksman. In spite of the 
fact that THINK Pascal hasn’t been updated for several years, | 
am still more productive using it than C++. 

I wish the technical support engineers who write the 
Symantec Top Ten would answer these two questions. 


#1 When is Symantec going to produce a new version of THINK 
Pascal that will generate both 680x0 and PowerPC code? 

#2 Why don’t they transplant the advanced editor, compiler and 
linker technologies found in THINK Pascal to their slow user 
hostile C++? 

— Fred Johnson 
70651.3171@compuserve.com 





NEWSBITS/DIALOG Box 69 





THE 
CLASSIFIEDS 




















MacRegistry 


Developer Job Oppor tunities 


If you are a Macintosh developer, you should register with 
us! We have a database that enables us to let you know about 
job opportunities. When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide. 


Marketability Assessment - To get a specific feel for your _ 
marketability send a resumé via Email or call. You may also 
request a Resume Workbook & Career Planner. 





Discreet - We are very careful to protect the confidentiality 
of a currently employed developer. 


Scientific Placement is managed by graduate en gineers, we 
enjoy a reputation for competent & professional job Place- 
ment services and we are Mac fanatics. 


1-800-231-5920 | AppleLink: D1580 | 713-496-0373 fax 


Scientific Placement, Inc. 


ban MT es ai pee MT or pa eea MacRegistry 
ox 4 


Houston. Texas 77224 San Henly CA 94583 Johnson city, OON 37602 
(713) 496-6100 510-733-6168 (615) 854-9444 
das @scientific.com bge@scientific.com jg @ scientific. cc com 









MAC PROFESSIONALS 


Manpower Technical, a leader 
in the Technical Services industry, 
has current and upcoming 
contract openings for experienced 
MAC personnel with the following 
expertise: Software Development, 
Network Administrators, Desk 
Top Publishing, Help Desk, 
Applications Support, Technical 
Writers/Editors. 

Positions are in California and 
throughout North America. 

Interested persons are encour- 
aged to send their resume to: 

Manpower Technical 
ATTN: Dept. MT 
P.O. Box 2053 
Milwaukee, WI 53201 


(800) 558-6992 
Fax # (414) 332-0378 






That’s what we 
thought of Scott 
when we found 
out he knew 


MacApp. 








Scott Laing, 
Programmer, 
and Adventurer 


MacXperts has openings for 
experienced C++ and MacApp 
programmers. If you have what it 
takes, and the desire to achieve, 
call Kendall Tyler at MacxXperts. 


Voice: 800-356-8040 Fax: 804-358-3847 
Internet: xperts@infi.net 
AppleLink: xperts AOL: MacXperts 










THE CLASSIFIEDS 





MacPlay, the premier Macintosh game 
company, is looking for an experienced 
Mac programmer to help us write killer 
Macintosh games. 


We intend to remain at the forefront of 
the Mac gaming world through innova- 
tive use of new technologies, including 
Power Macintosh, networking, and tex- 
ture-mapped, 3D polygon graphics. To 
do this, we need experienced Macintosh 
software engineers. We need Toolbox 
ninjas. We need experienced program- 
mers who are accustomed to writing 
optimized, high-performance Macintosh 
code, in a team environment working 
with artists, musicians, and producers. 


If you're interested in working with us, 
send a resume and work history along 
with applications you've written and 
sample source code. This is not a train- 
ing position. Experience is a must, not 
a plus. 


Send packages to: 


Bill Dugan 
Macintosh High Priest 
MacPlay 
17922 Fitch Avenue 
Irvine, CA 92714 
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Grolier Electronic Publishing ( GER. is an innovative publisher of multimedia CD-ROM and on- 


line educational and related products for the consumer market, and a rapidly growing division of 


Grolier Incorporated. 


KE .pansion at an unprecedented rate has created ee opportunities at our International 


Corporate Headquarters in Danbury, Connecticut. If you join G 


collaborative, results-oriented environment. 


, you'll be challenged by a high energy, 


Pr entiat candidates for these opportunities must be innovators who match the excitement of our 


products, our industry, and our objectives. 


Manager, 
Applications Program 


Manages applications programmers 
(Windows & Macintosh), software 
development methodologies, and 
research tools used in development. 
5+ years direct programming and 
software development experience, 
including a minimum of 2 years ina 
management capacity. 


Software Engineer 


Macintosh Programmer--You will 
be responsible for the development of 
interface code and technologies, with 
critical accountability for delivery of 
titles within tight deadlines. 3+ years 
experience with C\C++ in Macintosh 
environment; familiarity with Mac 
toolbox and interface standards. 


Software Engineer 


Editorial Database--You will 
design, create, and/or acquire tools 
for the creation /maintenance of text 
and hypermedia content and 
databases. 3+ years experience with 
one or more of the following: SGML, 
DTDs, database design and 
programming or editorial systems. 


Software Engineer 


Windows Programmer--You will 
be responsible for the development of 
interface code and technologies, with 
critical accountability for delivery 
within tight deadlines. 3+ years 
experience with C\C++ developing 
for Windows; knowledge of 
Windows API and interface 
standards. 


It’s time you discovered GMM, Our exciting career opportunities are accompanied by 
highly competitive salaries, as well as a comprehensive benefit package. Please mail or fax a 
resume with salary history and requirements (which must be included for consideration), 
indicating position of interest to: Human Resources, Attn: GEP, 

Grolier Hectronic Publishing, Sherman Turnpike, Danbury, CT 06816. Fax # 203-797-3284. 
(We will only respond to qualified candidates) Grolier is committed to workforce diversity 


GROLIER 


ELECTRONIC PUBLISHING 





If you have a CD-ROM drive, _ 
then you've gotta have every article 


published in the first 9 years of 
MacTech Magazine!! 


... now in THINK Reference format! 








MacTech CD -ROM Every article, 1100+ of them, from all 103 issues of MacTech Magazine printed 


Volumes 1-9: from 1984 through 1993. Articles ranging from Assembly to BASIC, C to Pascal, 
Forth to FORTRAN and more. And the articles are in THINK Reference! 


/ 


The articles have hyperlinks to relevant portions of the Inside Macintosh 
databases of THINK Reference. For example, if you are looking for 
information on Aliases, look at the MacTech articles on Aliases and use the 
hyperlinks to jump to the Inside Macintosh entry for the Alias Manager. And 
now, with the articles in THINK Reference, you can do free-text searches 8-10 
times faster than you could previously with On Location™ 2.0. 


/ 


These are the files that go with the magazine — the code that the articles are 
talking about. Use them in your own applications, with no royalties! 


Including Inside Macintosh Volumes 1-6 (7 MB). 





Build your simple application using a lean, mean application framework. 


“When I designed THINK Reference, I envisioned endless Experiment with new code without having to build a whole application 


databases at my fingertips. MacTech has doubled the around it! 
information that is just a mouse click away.” ff 
— Darrell LeBlanc, Formerly of Symaniec, 
Author, THINK Reference 2.0 The most complete set of FrameWorks 


archives known. 


“The CD strikes me as an impressive and very useful resource. Symantec’s THINK Reference 


The only disadvantage I’ve found is that each answer the Including: Universal Header Files, Discipline, | 2.0. Complete on-line guide 

databases yield exposes me to so many more issues, that I Macintosh Drag and Drop SDK, MacsBug, _ to Inside Macintosh, Vol. I-VI, 

find myself exploring the articles for the sheer wonder of it, Telephone Manager SDK, Thread Manager _ with cross referenced index, 

and thus putting off the real coding I should be doing. :-)” SDK, TrueEdit 1.8 and and more. detailed information of each 
— Nicholas De Mello 


function, procedure and 
detail needed when 
programming the Macintosh. 


MacTech CD Beta Tester 
..and other related BASIC programming 


information and tools. 


oes / SAV INNUDEON 
MVIAGAZINE™ 


FOR MACINTOSH PROGRAMMERS & DEVELOPERS 


MacTech CD-ROM, Volumes 1-9: 


Voice: 310/575-4343 ¢ Fax: 310/575-0925 $199 plus shipping and handling. $69 plus shipping and handling for 
AppleLink: MT.CUSTSVC upgrades from any previous version of the CD 
CompuServe: 71333,1063 
Internet: custservice@xplain.com All purchasers of the 1-9 CD will receive a FREE upgrade to the next 


America Online & GEnie: MACTECHMAG version of the CD when in becomes available. 































E-mail, Fax, write, or call us. You may use your VISA, MasterCard or 
American Express; or you may send check or money order (in US funds only): 
MacTech Magazine, P.O. Box 250055, Los Angeles, CA 90025-9590). 

Voice: 310/575-4343 ¢ Fax: 310/575-0925 





If you are an e-mail user, you can place orders or contact customer service at: 
e AppleLink: MT.CUSTSVC 
¢ CompuServe: 71333,1063 
e Internet: custservice@xplain.com 
e America Online: MT CUSTSVC 
e GEnie: MACTECHMAG 






SUBSCRIPTIONS 
US Magazine: $47 for 12 issues 

Canada: $59 for 12 issues 

International: $97 for 12 issues 

Domestic source code disk: $77 for 12 issues 
Int'l source code disk: $97 for 12 issues 






CD-ROM 
MacTech CD-ROM, Volumes I-IX: Includes over 1100 articles from all 103 issues 
(1984-1993) of MacTech Magazine (formerly MacTutor). All article text and source 
code. Now in THINK Reference format. The CD includes Symantec's THINK™ 

Reference 2.0, working applications with full documentation, product demos for 

developers and more. See advertisement, this issue: $199. Upgrades $69, e-mail, 
call or write for info. 






BOOKS 
The Best of MacTutor, Volume 1: Sold Out 

The Complete MacTutor, Volume 2: Sold Out 

The Essential MacTutor, Volume 3: $19.95 

The Definitive MacTutor, Volume 4: $24.95 

The Best of MacTutor, Volume 5: $34.95 

Best of MacTutor Collection, Volumes 3 — 5: $69 

Best of MacTutor, Volumes 6, 7, 8 & 9: Not available 





DISKS 
Source Code Disks: $8 each 
Topical Index (1984-1991) on disk: $5 






MAGAZINE BACK ISSUES 
Volumes 3, 4, 5, 6, 7, 8, 9 and 10: $5 each (subject to availability) 









SHIPPING, HANDLING & TAXES 
California: 

Source disk or single issue: $3 
Single book or multiple back issues: $5 
Two books: $8 © All other orders: $12 


California residents include 8.25% sales tax on all software, disks and books. 


Continental US: 
Source disk or single issue: $3 

Single book or multiple back issues: $7 
Two books: $15 e All other orders: $17 















Canada, Mexico and Overseas: Please contact us for shipping information. 


Allow up to 2 weeks for standard domestic orders, more time for international orders. 






PLEASE NOTE 
Source code disks and journals from MacTech Magazine are licensed to the purchaser 
for private use only and are not to be copied for commercial gain. However, the 
code contained therein may be included, if properly acknowledged, in commercial 
products at no additional charge. All prices are subject to change without notice. 
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MACTECH EXCLUSIVES 


MacTech Magazine is your 
exclusive source for these 
specific products: 


Ad Lib 2.0 The premier 

MacApp 3.0 compatible 
ViewEdit replacement. A powerful user- 
interface editing tool to build views for 
MacApp 3.0 and 3.1. Ad Lib allows 
subclassing of all of MacApp’s view 
classes including adorners, behaviors, 
and drawing environments. String and 
text style resources are managed 
automatically. Alternate display methods, 
such as a view hierarchy window, allow 
easy examination of complex view 
structures. Ad Lib includes source code 
for MacApp extensions that are supported 
by the editor — buttons can be activated 
by keystrokes, behaviors can be attached 
to the application object, and general 
purpose behaviors can be configured to 
perform a number of useful functions. 
Run mode allows the user to try out the 
views as they will work in an application. 
Templates can be created to add 
additional data fields to view classes. 
Editing palettes provide fast and easy 
editing of common objects and attributes. 
Works with ACI's Object Master (version 
2.0 and later) to navigate a project's user 
interface source code. $195 


FrameWorks Magazine: 
$8/issue, Subject to availability. 


FrameWorks Source 
Code Disk: $10/issue, 
Subject to availability. 


NEW! Five Years of Objects 
CD-ROM: = FrameWorks 


archives and source code from April 1991 
to January 1993, plus selected object- 
oriented publicly available software and 
demos. $95 


MADACON '93 CD-ROM: The 
highlights of MADACON '93, including 
Mike Potel on Pink, Bedrock, MacApp, 
OODLs, and more. Slides, articles, 
demos, audio, and QuickTime. $95 


NEW! MAScript 1.2 adds support 
for AppleScript to your 


MacApp 3.0.1 and 3.1 based applications. 
Make your application scriptable and 
recordable by building on a tried and 
tested framework for object model 
support. MAScript dispatches Apple 
events to the appropriate objects, creates 
object specifiers, and makes framework 
objects like windows and documents 
scriptable and recordable. Sample 


application shows you how to begin 
adding support for scripting and 
recording. MAScript includes complete 
source code. Install MAScript by 
modifying one MacApp source file, then 
adding another to your project. Future 
versions of MacApp will incorporate ° 
MAScript, so MAScript support you add 
now will work in the future. $199 


NEW! The Mjginer BETA 
System is a software 
development environment supporting 
object-oriented programming in the BETA 
programming language. BETA is uniquely 
expressive and orthogonal. BETA unifies 
just about every abstraction mechanism - 
including class, procedure, function, 
coroutine, process and exception - into 
the ultimate abstraction mechanism: the 
pattern. BETA includes: general block 
structure, strong typing, whole/part 
objects. The compiler: binary code 
generation, automatic garbage collection, 
separate compilation, interface to C, 
Pascal, and assembler. 


The system: persistent objects, basic 
libraries with containers classes, 
platform-independent GUI application 
frameworks on Unix, Mac and Windows 
NT, metaprogramming system. The tools 
available on Unix: the hyper structure 
editor supporting syntax directed editing, 
browsing, etc., and the source code 
debugger are currently being ported to the 
Macintosh system. The Mjginer BETA 
System for Macintosh requires MPW 
(basic set) 3.2 or later. 


Package containing compiler, basic 
libraries, persistent store, GUI framework, 
and comprehensive documentation. 
(Other packages are also available) $295 


OSA support 
includes attachability, recordability, 
scriptability, coercion, in addition to 
script execution, idling and i/o. Apple 
event support includes complex object 
specifiers, synchronous/asynchronous 
Apple event handling, and Apple event 
transactions for clients and servers. The 
Core Suite of Apple event objects is 
supported including the application, 
documents, windows, and. files. 
Documentation includes technology 
overview, cookbook, and sample code. 
$250 Savvy now supports MPW 3.1, 
3.11 and continues to support 3.01, as 
well as Supporting Metrowerks Code 
Warrior. This month only, special 
offer - All Savvy versions include free 
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copy of Savvy QuickTime! 


More Savvy includes all 

Savvy features plus Apple event support for all 
sub-classes of TEventHandler with extensive view 
support. Apple event support for text includes text 
attributes and sub-range specification. Recordability 
supports additional actions, and coercion includes 
additional types. Additional client and server Apple 
events. $450 


NEW! Super Savvy includes all More Savvy features 
plus compile, edit, and record scripts using built 


in script editor. View template editors, like Ad Lib, can 
attach scripts to view objects and modified scripts are saved 
with the document. Script action behavior allow quick 
access for executing and editing scripts attached to views. 
Text to object specifier coercion plus more. $700 


NEW! Savvy QuickTime Requires Savvy, More 
Savvy, or Super Savvy. Includes QuickTime, 
Apple event and view template support. Movies come out 
of the box ready to play, edit, and react to Apple events. 
They can be included in any view structure, including 
templates, and are displayed in the scrap view. Movie 
controls include volume, play rate, looping mode, display 
style, and other characteristics. $250 


NEW! Savvy DataBase Requires Savvy, More 
Savvy, or Super Savvy. Available Winter 
1994. $250 


MacTech Magazine is your exclusive source for 
available back issues of SFA's magazine, source 
code disks and assorted CD's. Call for more info 
and pricing. 


BOOKS 


Defying Gravity: The Making of Newton 
Doug Menuez and Markos Kounalakis. An in depth, 
dramatic account of the story of Newton’s creation. It 
is a technological adventure story; a fascinating case 
Study of the process by which an idea is born and then 
translated into a product on which careers and fortunes 
can be made or lost. It is a new kind of business book, 
one that captures through powerful photojournalism 
and a fast-paced text, the human drama and risk 
involved in the invention of a new technology for a new 
marketplace. 196 pgs., $20-95 $26.95 


The Elements of E-Mail Style by Brent Heslop 
and David Angell. Learn the rules of the road in the e- 
mail age. Concise, easy-to-use format explaining 
essential e-mail guidelines and rules. It covers style, 
tone, typography, formatting, politics and etiquette. It 
also outlines basic rules of composition within the special 
context of writing e-mail and includes samples and 
templates for writing specific types of e-mail 
Correspondence. 208 pages. $44.05 $13.45 


NEW! E-Mail Essentials by Ed Tittel & Margaret 
Robbins is a hands-on guide to the basics of e-mail, 
the ubiquitous networks communication system. The book is 
Suitable for both the casual e-mailer and the networking 
professional, as it covers everything from the installation of e-mail to 
the maintenance and management of e-mail hubs and message 
servers. The books explains the fundamental concepts and 
technologies of electronic mail, featuring chapters on Lotus 
applications and CompuServe, as well as information on upgrading, 
automation, message-based applications, and user training. E-mail 
Essentials is a step-by-step, jargon-free guide that will enable the e- 
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mail user to get the most out of the communication potentials of 
networking. 250 pp. $2496 $22.45 


NEW! Graphics Gems IV edited by Paul 
Heckbert Volume IV is the newest collection of 
carefully crafted, innovative gems. Al! of the gems are 
immediately accessible and useful in formulating clean, 
fast, and elegant programs. The C programming 
language is used for most of the program listings, 
although several of the gems have C++ implementations. 
An IBM or Macintosh disk containing all of the code from 
all four volumes is included. Includes one 3.5" high- 
density disk. $49-05 $44.95 


How To Write Macintosh Software by Scott 
Knaster is a great source for understanding Macintosh 
Programming techniques. Drawing from his years of 
experience working with programmers, Scott explains the 
mysteries and myths of Macintosh programming with wit 
and humor. The third edition, fully revised and updated, 
covers System 7 and 32-bit developments, and explores 
such topics as how and where things are stored in 
memory; what things in memory can be moved around 
and when they may be moved: how to debug your 
applications with MacsBug; how to examine your 
program's code to learn precisely what's going on when it 
runs. 448 pgs., $28-05 $26.05 


The Instant Internet Guide by Brent Heslop and 
David Angell. An Internet jump-start — how to access, use 
and navigate global networks. The Instant Internet Guide 
equips readers with the tools needed to travel the electronic 
world. The book highlights the most important sources of 
Internet news and information and explains how to access 
information on remote systems. It outlines how to use 
essential Internet utilities and programs and includes a 
primer on UNIX for the Internet. 224 pages $44.95 $13.45 


Learn C on the Macintosh by Dave Mark. This self- 
teaching book/disk package gives you everything you need 
to begin programming on the Macintosh. Learn to write, 
edit, compile, and run your first C programs through a series 
of over 25 projects that build on one another. The book 
comes with THIN C — a customized version of Symantec's 
THINK C, the leading programming environment for 
Macintosh. 464 pages, Book/disk: $8495 $31.45 


Learn C++ on the Macintosh by Dave Mark. After 
a brief refresher course in C, Learn C++ introduces the 
basic syntax of C++ and object programming. Then you'll 
learn how to write, edit, and compile your first C++ 
programs through a series of programming projects that 
build on one another as new concepts are introduced. Key 
C++ concepts such as derived classes, operator 
overloading, and iostream functions are all covered in 
Dave's easy-to-follow approach. Includes a special version 
of Symantec C++ for Macintosh. Book/disk package with 
3.5" 800K Macintosh disk. 400 pages, $86-95 $33.26 


Macintosh C Programming Primer Volume I, 
Second Edition, Inside the Toolbox Using 
THINK € by Dave Mark and Cartwright Reed. This new 
edition of this Macintosh programming bestseller is 
updated to include recent changes in Macintosh 
technology, including System 7, new versions of THINK C 
and ResEdit, and new Macintosh machines. Readers will 
learn how to use the resources, Macintosh Toolbox and 
interface to create stand-alone applications. 672 pages, 
$26-05 $24.25 

Macintosh C Programming Primer Volume 
ll, Mastering the Toolbox Using THINK C by 
Dave Mark. Volume II picks up where Volume | leaves off, 
covering more advanced topics such as: Color 





QuickDraw, THINK Class Library, TextEdit, and the 
Memory Manager: 528 pgs. $26-95 $24.25 


Macintosh Pascal Programming Primer 
Volume I, Inside the Toolbox Using THINK 
Pascal by Dave Mark and Cartwright Reed. This 
tutorial shows programmers new to the Macintosh how to 
use the Toolbox, resources, and the Macintosh interface 
to create stand-alone applications with Symantec’s THINK 
Pascal. 544 pages $26-05 $24.25 


Macintosh Programming Techniques by Dan 
Sydow (Series Editor: Tony Meadow). This tutorial and 
handbook provides a thorough foundation in the special 
techniques of Macintosh programming for experienced 
Macintosh programmers as well as those making the 
transition from DOS, Windows, VAX or UNIX. Emphasizes 
programming techniques over syntax for better code, 
regardless of language. Guides the reader through 
Macintosh memory management, QuickDraw, events and 
more, using sample program in C++. Disk includes an 
interactive tutorial, plus reusable C++ code. $84.95 $31.95 


NEW! Multimedia Authoring Building and 
Developing Documents by Scott Fisher 
addresses the concerns that face anyone trying to create 
multimedia documents. It offers specific advice on when 
to use different kinds of information architecture, 
discusses the human-factors concepts that determine how 
readers use and retain information, and them applies these 
findings to multimedia documents, covering the high-level 
issues concerning planners and authors of multimedia 
documents as well as those involved in evaluating or 
purchasing multimedia platforms. Includes one 3.5" high- 
density disk. $84.06 $31.45 


NEW! Programming for the Newton 
Software Development’ with 
NewtonScript by Julie McKeehan and Neil Rhodes. 
Foreword by Walter R. Smith. Programming for the Newton: 
Software Development with NewtonScript is an 
indispensable tool for Newton programmers. Readers will 
learn how to develop software for the Newton on the 
Macintosh from people that developed the course on 
programming the Newton for Apple Computer. The enclosed 
3.9° disk contains a sample Newton application from the 
books, as well as demonstration version of Newton Toolkit 
(NTK), Apple Computers complete development environment 
for the Newtons. A Publication of AP Professional May 
1994, Paperback, 393 pp. $29-05 $26.95 


Programming in Symantec C++ for the 
Macintosh by Judy May and John Whittle. This book 
will introduce you to object-oriented programming, the 
C++ language, and of course Symantec C++ for the 
Macintosh. You don't have to be a programmer, or even 
know anything about programming to benefit from this 
book. Programming in Symantec C++ for the Macintosh 
covers everything from the basics to advanced features of 
Symantec C++. If you are a Think C or Zortech C44 
programmer who wants to learn more about object- 
oriented programming or what's different about Symantec 
C++, there are chapters specifically for you. Includes 
helpful examples of C++ code that illustrate object- 
oriented programs. $29-05 $26.95 


Programming for System 7 by Gary Little and Tim 
Swihart, is a hands-on guide to creating applications for 
System 7. It describes the new features and functions of 
the operating system in detail. Topics covered include file 
operations, cooperative multitasking, Balloon Help, Apple 
events, and the File Manager. Numerous working C code 
examples show programmers how to take advantage of 
each of these features and use them in developing their 
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applications. 384 pages $26-05 $24.25 


ResEdit™ Complete, Second Edition by Peter 
Alley and Carolyn Strange. With ResEdit, Macintosh 
programmers can customize every aspect of their interface 
form creating screen backgrounds and icons to 
customizing menus and dialog boxes. 608 pages. 
Book/disk package. 84-05 $31.45 


Sad Macs, Bombs, Disasters and What to 
Do About Them by Ted Landau comes to the rescue 
with your Macintosh problems. From fractious fonts to 
the ominous Sad Macintosh icon, this emergency 
handbook covers the whole range of Macintosh problems: 
symptoms, causes, and what you can do to solve them. 
640 Pages $24.06 $22.45 


Software By Design: Creating User Friendly 
Software by Penny Bauersfeld (Series Editor: Tony 
Meadow). This excellent reference provides readers with a 
thorough how-to for designing software that is easy to 
learn, comfortable to operate and that inspires user 
confidence. Written from the perspective of Macintosh, 
but compatible with all platforms. Stresses user input 
from initial design, through prototyping, testing and 
revision. Provides tools for analyzing user needs and test 
responses. Includes exercises for sharpening user- 
oriented design skills. $29-06 $26.95 


NEW! Taligent's Guide to Designing 
Programs: Well-Mannered Object- 
Oriented Design in C++ is the Taligent approach to 
object-oriented design. The Taligent Operating 
Environment is the first commercial software system 
based entirely on object-oriented technology. Taligent's 
Guide to Designing Programs is a developer's-eye view of 
this system. It introduces new concepts of programming 
and empowers developers to create software more 
productively. Out of their direct experience in developing 
the system, the authors focus on global issues of object- 
oriented design and writing C++ programs, and the 
specific issues of programming in the Taligent Operating 
Environment. Taligent's Guide to Designing Programs 
assumes the reader is an experienced C++ programmer, 
and proceeds from there to fully explore "the Taligent way’ 
of programming. $4059 $17.55 


Writing Localizable Software for the 
Macintosh by Daniel R. Carter. 469 pages. $26-05 
$24.25 


THE APPLE LIBRARY 


HyperCard Stack Design Guidelines by Apple 
Computer, Inc. is an essential book for everyone who 
creates Apple HyperCard stacks, from beginners to 
commercial developers. It covers the basic principles of 
design that, when incorporated, make HyperCard stacks 
effective and usable. Topics include guidelines, 
navigation, graphic design and screen illustration, text in 
Stacks, music and sound, a sample stack development 
scenario, collaborative development, and the Stack 
Design Checklist. 240 pages, $4-95 $19.95 


Inside AppleTalk by Gursharan S. Sidhu, Richard F. 
Andrews and Alan B. Oppenheimer. Apple Computer, Inc. 
650 pages, $8495 $31.45 


Inside Macintosh: AOCE Application 
Interfaces by Apple Computer, Inc. shows how your 
application can take advantage of the system software 
features provided by PowerTalk system software and the 
PowerShare collaboration servers. Nearly every Macintosh 
application program can benefit from the addition of some 
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of these features. This book shows how you can add 
electronic mail capabilities to your application, write a 
messaging application or agent, store information in and 
retrieve information from PowerShare and other AOCE 
catalogs, add catalog-browsing and find-in-catalog 
capabilities to your application, write templates that extend 
the Finder's ability to display information in PowerShare 
and other AOCE catalogs, add digital signatures to files or 
to any portion of a document, and establish an 
authenticated messaging connection. $40-46 $36.40 


Inside Macintosh: AOCE Service Access 
Modules by Apple Computer, Inc. describes how to write 
a software module that gives users and PowerTalk-enabled 
applications access to a new or existing mail and 
messaging service or catalog service. This book shows 
how to write a catalog service access module (CSAM), a 
messaging service access module (MSAM), and AOCE 
templates that allow a user to set up a CSAM or MSAM and 
add addresses to mail and messages. $26-06 $24.25 


Inside Macintosh: CD-ROM by Apple 

Computer, Inc. Inside Macintosh® is the 
essential reference for programmers, designers, and 
engineers for creating applications for the Macintosh family 
of computers. Inside Macintosh CD-ROM collects more 
than 25 volumes in electronic form, including: QuickDraw™ 
GX Library, Macintosh Human Interface Guidelines, 
PowerPC System Software, Macintosh Toolbox Essentials 
and More Macintosh Toolbox, QuickTime and QuickTime 
Components. Now programmers will be able to access over 
16,000 pages of the information they need directly from their 
computers. Hypertext linking and extensive cross 
referencing across volumes allows programmers to search 
and explore this library in ways that are unique to the 
electronic medium. Every Macintosh programmer will regard 
Inside Macintosh CD-ROM as their most important resource. 
$99.95 


Inside Macintosh: Devices by Apple Computer, 
Inc. describes how to write software that interacts with 
built-in and peripheral hardware devices. With this book,. 
you'll learn how to write and install your own device 
drivers, desk accessories, and Chooser extensions; 
communicate with device drivers using the Device 
Manager; access expansion cards using the Slot Manager; 
control SCSI devices using SCS! Manager 4.3 or the 
original SCSI Manager; communicate directly with Apple 
Desktop Bus devices; interact with the Power Manager in 
battery-powered Macintosh computers; and communicate 
with serial devices using the Serial Driver. $29-06 $26.95 


Inside Macintosh: Files by Apple Computer, Inc. 
describes the parts of the operating system that allow you to 
manage files. It shows how your application can handle the 
commands typically found in a File menu. It also provides a 
reference to the File and Alias Managers, the Disk Initialization 
and Standard File Packages. 510 pgs, $20-05 $26.95 


Inside Macintosh: Interapplication Com- 
munication by Apple Computer, Inc. shows how 
applications can work together. How your application can 
share data, request information or services, allow the user 
to automate tasks, communicate with remote databases. 
$34.05 $31.45 


Inside Macintosh: Imaging by Apple Computer, 
Inc. covers QuickDraw and Color QuickDraw. The book 
includes general discussions of drawing and working with 
color. It describes the structures that hold images and 
image information, and the routines that manipulate them. 
It also covers the Palette, Color, and Printing Managers, 
and the Color Picker, Color Matching, and Picture 
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Utilities. $26-98 $24.25 


Inside Macintosh: Macintosh Toolbox 
Essentials by Apple Computer, Inc. covers the heart of 
the Macintosh. The toolbox enables programmers to 
create applications consistent with the Macintosh “look 
and feel”. This book describes Toolbox routines and 
shows how to implement essential user interface 
elements, such as menus, windows, scroll bars, icons and 
dialog boxes. 880 pages $34-05 $31.45 


Inside Macintosh: More Macintosh Toolbox 
by Apple Computer, Inc. covers other Macintosh features 
such as how to support copy and paste, provide Balloon 
Help, play and record sound and create control panels are 
covered in this volume. The managers discussed include 
Help, List, Resource, Scrap and Sound. $8466 $31.45 


Inside Macintosh: Memory by Apple Computer, 
Inc. describes the parts of the Macintosh operating 
system that allow you to manage memory. It provides 
detailed strategies for allocating and releasing memory, 
avoiding low-memory situations, reference to the Memory 
Manager, the Virtual Memory Manager, and memory- 
related utilities. 296 pages, $2405 $22.45 


Inside Macintosh: Networking by Apple 
Computer, Inc. describes how to write software that uses 
Appletalk networking protocols. It describes the 
components and organization of AppleTalk and how to 
select an AppleTalk protocol. It provides the complete 
application interfaces to all AppleTalk protocols, including 
ATP (AppleTalk Transaction Protocol), DDP (Datagram 
Delivery Protocol), and ADSP (AppleTalk Data Stream 
Protocol), among others. $20-06 $26.95 


Inside Macintosh: Operating System Utilities 
by Apple Computer, Inc. describes parts of the Macintosh 
Operating System that allow you to manage various low- 
level aspects of the operating system. Everyone who 
programs the Macintosh should read this book! It will show 
you in detail how to get information about the operating 
system, manage operating system queues, handle dates and 
times, control the settings of the parameter RAM, 
manipulate the trap dispatch table, and receive and respond 
to low-level system errors. $26-05 $23.45 


Inside Macintosh: Overview by Apple Computer, 
Inc. is the first book that people who are unfamiliar with 
Macintosh programming should read. It gives an 
overview of Macintosh programming fundamentals and a 
road map to the New Inside Macintosh library. Inside 
Macintosh: Overview also covers various programming 
tools and languages, compatibility guidelines and an 
overview of considerations for worldwide development. 
176 pages, $2206 $20.65 


Inside Macintosh: PowerPC Numerics by Apple 
Computer, Inc. describes the floating-point numerics 
environment provided with the first release of PowerPC 
processor-based Macintosh computers. The numerics 
environment conforms to the IEEE standard 754 for binary 
floating-point arithmetic. This book provides a description 
of that standard and shows how RISC Numerics compiles 
with it. This book also shows programmers how to create 
floating-point values and how to perform operations on 
floating-point values in high-level languages such as C and 
in PowerPC assembly language. $28-06 $26.00 


Inside Macintosh: PowerPC System 
Software by Apple Computer, Inc. describes the new 
process execution environment and system software 
services provided with the first version of the system 
software for Macintosh on PowerPC computers. It 
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contains information you need to know to write 
applications and other software that can run on the 
PowerPC. PowerPC System Software shows in detail how 
to make your software compatible with the new run-time 
environment provided on PowerPC-based Macintosh 
computers. It also provides a complete technical reference 
for the Mixed Mode Manager, the Code Fragment 
Manager, and the Exception Manager. $2405 $22.45 


Inside Macintosh: Processes by Apple 
Computer, Inc. describes the parts of the Macintosh 
operating system that allow you to control the execution 
Of processes and interrupt tasks. It shows in detail how 
you can use the Process Manager to get information 
about processes loaded in memory. It is also a reference 
for the Vertical Retrace, Time, Notification, Deferred Task, 
and Shutdown Managers. 208 pages, $2496 $20.65 


Inside Macintosh: QuickTime by Apple 
Computer, Inc. is for anyone who wants to create 
applications that use QuickTime, the system software that 
allows the integration of video, animation, and sounds 
into applications. This book describes all of the 
QuickTime Toolbox utilities. In addition, it provides the 
information you need to compress and decompress 
images and image sequences. $20-05 $26.95 


Inside Macintosh: QuickTime Components 
by Apple Computer, Inc.covers how to use and develop 
QuickTime components such as image compressors, 
movie controllers, sequence grabbers, and video 
digitizers. $84.05 $31.45 


Inside Macintosh: Sound by Apple Computer, Inc. 
describes the parts of the Macintosh system software that 
allow you to manage sounds. It contains information that 
you need to know to write applications and other software 
that can record and play back sounds, compress and 
expand audio data, convert text to speech, and perform 
other similar operations. $26-95 $24.25 


Inside Macintosh: Text by Apple Computer, Inc. 
describes how to perform text handling, from simple 
character display to multi-language processing. The 
Font, Script, Text Services, and Dictionary Managers are 
all covered, in addition to QuickDraw Text, TextEdit, and 
International and Keyboard Resources. $80-95 $35.95 


Inside Macintosh: QuickDraw™ GX Library by 
Apple Computer, Inc. is the powerful new graphics 
architecture for the Macintosh. Far more than just a 
revision of QuickDraw, QuickDraw GX is a unified approach 
to graphics and typography that gives programmers 
unprecedented flexibility and power in drawing and printing 
all kinds of shapes, images, and text. This long-awaited 
extension to Macintosh system software is documented in a 
library of books that are themselves an extension to the new 
Inside Macintosh series. The QuickDraw GX Library is 
clear, concise, and organized by topic. The books contain 
detailed explanations and abundant programming 
examples. With extensive cross-references, illustrations, 
and C-language sample code, the QuickDraw GX Library 
gives programmers fast and complete reference information 
for creating powerful graphics and publishing applications 
with sophisticated printing capabilities. The first two 
volumes in the QuickDraw GX Library are: 


Inside Macintosh: QuickDraw GX Objects by 
Apple Computer, Inc. introduces QuickDraw GX and its 
object structure, and shows programmers how to manipulate 
objects in all types of programs. $26-05 $24.25 


Inside Macintosh: QuickDraw GX Graphics by 
Apple Computer, Inc. shows readers how to create and 
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manipulate the fundamental geometric shapes of QuickDraw 
GX to generate a vast range of graphic entities. It also 
demonstrates how to work with bitmaps and pictures, and 
specialized QuickDraw GX graphic shapes. $26-95 $24.25 


Inside Macintosh: X-Ref. by Apple 
Computer, Inc. is an index for Inside Mac. 
2-05 $11.65 


LANGUAGES 


CodeWarrior™ CD by Metrowerks 
comes intwo versions — Bronze and 
Gold. These CDs contain the 
CodeWarrior development environment 
including C++, C and Pascal compilers: 

high-speed linkers; native-mode 
WMS interactive debuggers: and a powerful 
new application framework called PowerPlant for rapid 
Macintosh development in C++. Bronze generates 680x0 
code. Gold generates both 680x0 and PowerPC code. All 
versions are a 3 CD subscription over a 1-year period. 
Bronze: $99, Gold: $399. Bronze comes with a 6- 
month MacTech subscription. Gold comes with a 
1-year subscription. Both at no additional charge! 


NEW! Geekware by 
Metrowerks is here! 
In high school, they called 
you a computer geek. Now, 
they work at burger joints and 


wear polyester uniforms. And you don’t. Wear it to your 
favorite burger joint. $24.95 











FORTRAN by Language Systems is a full-featured ANS! 
Standard FORTRAN 77 compiler that runs in the 
Macintosh Programmers Workshop (MPW). All major 
VAX extensions are Supported as well as all major 
features of Cray and Data General FORTRAN. FORTRAN 
Creates System 7 savvy applications quickly and easily. 
Compiler options specify code generation and 
Optimization for all Macintoshes, including special 
optimizations for 68040 machines. Error messages are 
written in plain English and are automatically linked to the 
source file. The runtime user interface of compiled 
FORTRAN programs is fully customizable by 
Programmers with any level of Macintosh experience. 
$595. w/o MPW: $495. Corporate 5 pack $1575 


FORTRAN 77 SDK for Power Macintosh by Absoft 
includes a globally optimizing native compiler and linker, 
native Fx™ multi-language debugger, and Apple's MPW 
development environment. The compiler is a full ANSI/ISO 
FORTRAN 77 implementation and includes all MIL-STD 1753 
extensions, Cray/Sun-style POINTER, and several Fortran 90 
enhancements. MRWE, Absoft’s application framework 
libraries, is included as is the MIG graphics library for quick 
creation of plots and graphs. The native Macintosh PPC 





toolbox is fully supported. Absoft's Fx debugger can debug 
intermixed FORTRAN 77,C, C++, PPC assembler. The 
compiler, linker, and debugger all run as native PPC tools and 
produce native Macintosh PPC executables. $699 


MacFortran® Il V3.3 is a VAX/VMS compatible, 
full ANSI/ISO FORTRAN 77 compiler including all MIL- 
STD 1753 extensions. Acknowledged to be the fastest 
FORTRAN available for Macintosh, MacFortran II is 
bundled with the latest version of Macintosh 
Programmers Workshop (MPW), and includes 
SourceBug (Apple’s source level symbolic debugger) and 
SoftwareFPU (a math co-processor emulator). Also 
included is Absoft's Macintosh Runtime Window 
Environment (MRWE) application framework (with fully 
documented source code as examples) and MIG graphics 
library. MacFortran |I v3.3 features improved 68040CPU 
Support and is fully compatible with Power Macintosh 
under emulation. Documentation includes special 
sections devoted to use of MacFortran II with the MPW 
editor and linker, implementation of System 7 features, 
and porting code to the Macintosh from from various 
mainframes and Unix workstation platforms. $595 


pass BASIC for the Newton is 
BASIC for the Newton! From NS BASIC 
Beer Corporation, it is a fully interactive 
eae implementation of the BASIC programming 
NS BASIC language. It runs entirely on the Newton - 
no host is required. It includes a full set of functions and 
data types, hand-written input, windows, buttons and 
extensions to take advantage of the Newton environment. 
Applications can create files or access the built-in soups. 
Applications can also access the serial port for input and 
output. Work directly on the Newton, or through a 
connected Mac/PC and keyboard. NS BASIC includes a 
150 page pocket sized manual. $99 


SmalitalkAgents™ a 
Superset of the Smalltalk 
language, is fully integrated 
with Macintosh, incor- 
porating design features 
specifically for the RISC and Macintosh System 7 
architecture. SmalltalkAgents is a true object oriented 
workbench that includes an incremental and extensible 
compiler, an array of design and cross reference tools, 
pre-emptive interrupt driven threads and events, an 
extensive class library including classes for general 
programming, classes for the Macintosh user interface and 
Classes for the Macintosh operating system. Integration of 
components in enterprise systems is simplified with the 
network, telecommunication, and inter-application 
communication libraries. The SmalltalkAgents’ extensive 
Class library and add-on components make it especially 
well suited as a development workbench for custom 
applications in business, education, science, engineering, 
and academic research. $695 


SAVINNGHSON 


Symantec C++ for Macintosh is an object 
oriented development environment designed for 
professional Macintosh programmers. Symantec C++ 
features powerful object-oriented development tools 
within a completely integrated environment. The C++ 
compiler, incremental linker, THINK Class Library, 
integrated browser, and automatic project management 
give Symantec C++ fast turnaround times. This product 
supports multiple editors and translators, so you can use 
your favorite tools and resource editors as well as scripts 
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you ve written within the environment. And with ToolServer, 
youll be able to customize menus and attach scripts based 
on Apple events, AppleScript, and MPW Tools. The built-in 
Sourceserver provides a source code control system, 
allowing teams of programmers to solve tough problems 
faster. With SourceServer, you'll always know you're 
working on the latest version. And you'll have old versions 
at your fingertips when code “breaks” and you need to look 
back at modifications. Product Contents: Three high 
density disks, an 832-page user manual, a 568-page THINK 
Class Library and a 100-page C++ Compiler Guide. $369 


THINK G by Symantec Corporation. THINK C is easy to use 
and highly visual, making it the No. 1 selling Macintosh 
programming environment. Enhancements make this product 
faster and more versatile than ever, improving your 
productivity with more powerful project management, a full set 
of tools, and script support for major script-based languages. 
With the THINK environment, you spend less time on routine 
programming tasks due to an extremely fast compiler and 
incremental linker. In addition, the automatic project manager 
Saves you time by tracking changes to your files and 
recompiling only those that have changes. All the tools you 
need — a multi-window editor, compiler, linker, debugger, 
browser, and resource editor — are completely integrated for 
speed and ease of use. One of the most valuable of these tools 
is the THINK Class Library, a set of program building blocks 
that gives you a head start in writing object-oriented 
applications. And with the new open architecture, you can use 
your favorite tools, resource editors, and scripts within the 
environment. THINK C is the logical next step for 
programmers who have worked in HyperCard or other script- 
based development environments. The environment supports 
AppleScript, Apple events, and Frontier, so you can link and 
automate complex, multi-project operations. Product 
Contents: Four Macintosh disks, an 832-page user manual, 
and a 568-page THINK Class Library Guide. $219 


THINK Pascal v. 4.0 by Symantec Corporation. 
Professionals and students will welcome this version of 
THINK Pascal. It is fully integrated for rapid turnaround 
time and lets you take advantage of System 7 capabilities. 
Features include support for large projects, enhanced 
THINK Class Library, System 7 compatibility, superior 
code generation, and smart linking. Product Contents: 
Four Macintosh disks, a 562-page user manual, and a 
498-page object-oriented programming manual. $169 


UTILITIES 


BBEdit 3.1 from Bare Bones Software is now 

better than ever. In addition to being Accelerated 
for Power Macintosh, this powerful, intuitive text editor 
Offers integrated support for THINK C 7.0, Metrowerks 
CodeWarrior, THINK Reference 2.0 and MPW ToolServer. 
Version 3.1 adds even more capability, including “soft’ 
wrapping of text on screen and numerous refinements and 
improvements to the user interface. BBEdit's many features 
include: Integrated PopupFuncs(TM) technology for speedy 
navigation of source code files (C, C++, Pascal, Rez, 68K 
Assembler, and Fortran), unique ‘Find Differences’ 
command (BBEdit can find differences between projects 
and folders as well as files), support for Macintosh Drag 
and Drop for editing and other common tasks, PowerTalk 
Support for reading, sending and composition of PowerTalk 
mail, scripting via any OSA compatible scripting language 
including AppleScript and Frontier 3.0, and fast search and 
replace with optional "grep" matching and multi-file 
searching. BBEdit's robust feature set and proven 
performance and reliability make it the editor of choice for 
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professionals and hobbyists alike. $119 


C Programmer’s Toolbox/MPW Rev. 3.0 by 
MMCAD. The C Programmer's Toolbox provides a wealth 
Of programming and documentation support tools for 
developers who are creating new code, porting existing 
code, or trying to improve and expand existing code. The 
tools include: CDecl composes and translates C/C++ 
declaration statements to/from English; CFlow™ 
determines program function hierarchy, runtime library 
contents, function/file interdependencies and graphs all or 
part of a program’s functional structure; CHilite™ 
highlights and prints C/C++ files; CLint™ semantically 
checks multiple C source files, identifying potential 
programming bugs; CPrint™ reformats, beautifies and 
documents C/C++ source files; and more... Works with 
MPW C/C++, THINK C, requires Apple’s MPW. $295 


CLimate by Orchard Software is a command line 
interface that lets you communicate with your Macintosh 
using English commands to create, delete, rename, and 
move files and folders. It can start applications, format 
disks, restart your computer, etc. CLilmate supplements 
the Finder. It includes a BASIC interpreter that lets you 
script your Macintosh without AppleScript. The 
interpreter includes advanced programming constructs: 
repeat loops, if/then/else conditionals, subroutine calls, 
etc... CLlmate implements wildcard characters, enabling 
you to work on groups of files. Use CLImate instead of 
MPW to manage your projects. CLimate is an application 
occupying 70K disk space. It comes bundled with sample 
programs and full documentation. $59.95 


CMaster 2.0 by Jersey Scientific installs into THINK C 
5 /6/7 and Symantec C++ for Macintosh, and enhances 
the editor. Use its function popup to select a function and 
CMaster takes you right to it. Other features include 
multiple clipboards and markers, a Function Prototyper, 
and a GoBack Menu which can take you back to previous 
editing contexts. Almost all features bindable to the 
keyboard, along over a hundred keyboard-only features 
like “Add New Automatic Variable.” Glossaries, 
AppleScript and ToolServer support, Macros, and External 
Tools you create too! $129.95 


Cron Manager by Orchard Software implements the 
UNIX Cron facility. It can open any Macintosh file on a 
given date and time. By creating an alias, renaming it to 
the date and time to open, and moving it into the special 
Cron Events Folder, Cron Manager will open it. Cron 
Manager is a control panel that creates the special Cron 
Events Folder inside your System Folder. It is completely 
transparent to the user. It works like the Startup Items 
folder, only smarter. It works with any Macintosh file: if 
you can double-click to start it, Cron Manager can open 
it. $26.95. Cron Manager bundled with CLimate, $59.95 


Dialog Maker by Electric Software Corporation. 
Migrating from C to C++? Dialog Maker can ease your 
transition. Dialog Maker is an object-oriented programming 
library for MPW C++ and Symantec C++ (MPW and 
Symantec Development Environment versions) which 
contains a complete set of routines that create a high level 
interface to dialogs. Dialog Maker provides a small number 
of simple, yet powerful routines to access and manipulate 
dialogs. Resources are used to control the most common 
dialog behavior allowing you to develop your application 
lightning fast. Minimum requirements System 7.0, MPW 
3.2, MPW C++ 3.2, or Symantec C++ 6.0. $149 


dtF is a true relational database system for Apple 
Macintosh computers. dtF provides a powerful choice for 
developers who want to create database centered 
applications with no performance trade-offs. dtF features 
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SQL, full transaction control, error recovery, single user, 
client server architecture and multi-platform support 
including DOS, Windows, 0S/2 and UNIX. The C/C++ API 
is identical and fully portable cross all supported 
platforms. Third-party vendors supporting dtF will be able 
to offer a variety of advanced features and benefits to their 
customers royalty free. Tools are included for importing, 
exporting, creating and managing databases and users. 
Supported development environments include: Symantec, 
MPW, MetroWerks and more. Mac/SDK: $695 


InstallerPack™ by StepUp Software is a package of 
several Installer “atoms” that let developers incorporate 
graphics, sounds, file compression and custom folder 
icons into installation scripts. Compression formats 
Supported are Compact Pro & Diamond. Each atom also 
available separately: $219 


Last Resort Programmer’s Edition records 
every keystroke, command key and mouse event (in local 
coordinates) to a file on your hard disk. This is especially 
useful for program testing & debugging, and for technical 
Support and help desks. If Something goes wrong 
(because of a power failure, system crash, forgetting to 
Save or deleting lines) and you lose a word, phrase, or 
document you can look in the Last Resort keystroke file 
and recover what you typed. Last Resort is also useful for 
technical support personnel, when they have to ask “What 
was the last thing you did before...?” $74.95 


LJ Profiler by Lars Jordebo Datakonsult 

supports profiling of C++ 68K and Power PC 
applications compiled with CodeWarrior, CFront or 
Symantec C++. Based on active profiling, i.e. profiling 
code called at function enter and exit, the browser 
application lets you follow call chain timings in 
hierarchical views or separate windows. Collect, 
Organize, compare and save profiling data from different 
versions of your application into a project. Scriptable and 
recordable with full access to most internal data 
Structures. Optional remote profiling and tracking of 
Segment and stack usage. Full source code to what you 
link into your application. $295. 


LS Object Pascal CD includes the world’s first Object 
Pascal compiler for Power Macintosh. 100% compatible 
with Apple’s MPW Pascal, LS Object Pascal combines the 
best of Apple's native development tools with innovative new 
technology developed at Language Systems. Compiler 
options specify 68K or native PowerPC code generation. 
Included on the CD are: LS Object Pascal compiler, 
Universal Pascal Toolbox interfaces, fully loaded MPW 
3.3.1, 68K and PowerPC source debuggers, PowerPC 
assembler, online documentation, Macintosh Tech Notes, 
and a special version of AppMaker by Bowers Development 
that generates native Pascal source code. The beta release 
includes upgrades to v1.0 when it becomes available. $399 


Spellswell 7 1.0.4 is an award-winning, 
comprehensive, practical spelling checker that works in 
batch mode or within applications that incorporate the 
Apple Events Word Services protocol (e.g., Eudora, 
WordPerfect, Communicate!, and Fair Witness). 
Spellswell 7 checks for spelling errors as well as common 
typos like capitalization errors, spaces before punctuation, 
double double word errors, abbreviation errors, mixed 
case errors, extra Spaces between words, a/an before 
vowel/consonant, etc... MacTech orders include developer 
kit with Writeswell Jr., a Sample Apple Events Word 
Services word-processor and its source code. $74.95 


MacAnalyst by Excel Software supports software 
engineering methods including structured analysis, data 


MAIL ORDER STORE 


; a MAIL ORDER STORE 


modeling, screen prototyping, object-oriented analysis, 
and data dictionary. This language independent tool is 
used by system analysts and software designers. Demo 
$79, Product $995 


MacAnalyst/Expert by Excel Software supports 
software engineering methods with the capabilities of 
MacAnalyst plus state transition diagrams, state transition 
tables, decision tables and process activation tables. An 
integrated requirement database provides traceability from 
requirement statements to analysis or design diagrams, 
code or test procedures. This tool is well suited to the 
analysis and design of real-time or requirements driven 
projects. Demo $79, Product $1595 


MacDesigner by Excel Software supports software 
engineering methods including structured design, object- 
oriented design, data dictionary and code browsing. This 
tool is well suited to detailed design or maintenance of 
software development projects. Demo $79, Product $995 


MacDesigner/Expert by Excel Software supports 
software engineering methods with the capabilities of 
MacDesigner plus multi-task design. An integrated 
requirement database provides traceability from requirement 
Statements to design diagrams, code or test procedures. 
This tool is well suited to design or maintenance of real-time, 
multi-tasking software projects. Demo $79, Product $1595 


MacA&D by Excel Software combines the capabilities of 
MacAnalyst/Expert and MacDesigner/Expert into a single 
application. It supports structured analysis and design, 
Object-oriented analysis and design, real-time extensions, 
task design, data modeling, screen prototyping, code editing 
and browsing, reengineering, requirement traceability, and a 
global data dictionary. Demo $149, Product $2995 


MacWireFrame by Amplified 
Intelligence. Create your own virtual reality 
application with MacWireFrame, a virtual 


reality application frame work. Includes a 
complete library of object oriented graphics routines, its 
own easy to understand application frame work (similar to 
MacApp or TCL but a lot easier to understand), plus an 
example application program that lets you start solid 
modeling right away. Comes complete with fully 
documented source code. All new purchases will be 
guaranteed a $49.99 upgrade to the soon to be released, 
scriptable, MacWireFrame 5.0. Due to the overwhelming 
response the special price offer has been extended for a 
little while longer. Special Offer: $299-66 $75!!!! 


The Memory Mine™ by Adianta is a stand alone 
debugging tool for Macintosh and native PowerPC. 
Programmers can monitor heaps, identify problems such 
as memory leaks, and stress test applications. Active status 
of memory in a heap is sampled on the fly: allocation in 
non-relocatable (Ptr), relocatable (Handle) and free space is 
shown, aS are heap corruption, fragmentation, and more... 
Allocate, Purge, Compact, and Zap memory let users stress 
test all or part of a program. Source code is not needed to 
view heaps. It works on Macintoshes with 68020 or later 
and System 7.0 or later. $99 


p1 Modula-2 V5.1 is a full implementation 
of the ISO Standard for Modula-2 which includes 
exception handling, termination, complex numbers, value 
constructors, a standard library and more. In addition it 
Supports objects and MacApp, foreign language calls, all 
current MPW interfaces, optimized 680x0 instructions, 
three floating point types with four modes of operation, etc. 
A symbolic window debugger, several utilities and a set of 
examples (including MacApp tutorial) are included. p1 
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Modula-2 requires MPW. It is targeted for professional 
development and prompt technical support by e-mail or 
FAX is granted. $395, corporate 5 pack $1175 


PictureCDEF 1.3 by Paradigm Software is 

a professional-level CDEF for creating custom 
graphical buttons (8-64 pixels). PictureCDEF is used in 
products by Adobe, ProVue, STF Technologies and others. 
It is multi-monitor and bit-depth sensitive. The button 
graphic (cicn, ResEdit) can be changed at runtime and 
even animated with a call-back routine. Create distinct 
buttons in seven variations: MultiState, PushButton, 
FlexiButton, ToggleButton, ChkButton, PushPictButton and 
TogglePictButton. Position the optional button title at left, 
bottom or right, or follow the system text direction for 
q international support. Manual, 
a sample code and MacApp 3.0 
# support included. Full source code: 
$95.00 Object code: $45.00. 


Qd3d/3dPane/SmartPane source code bundle by 
Vivistar Consulting. Qd3d 2.0: Full featured 3d 
graphics. Points; lines; polygons; polyhedra; Gouraud 
Shading; z-buffering; culling; depth cueing; parallel, 
perspective, and stereoscopic projections; performance 
enhancing “OnlyQD” and “Wireframe” modes; full 
clipping; pipeline access: animation and model 
interaction support; and a “triad mouse” to map 2d mouse 
movement to 3d. 3dPane 2.0: Integrates Qd3d with 
the TCL and provides a view orientation controller. 
SmartPane: Offscreen image buffering, flicker free 
animation, and QuickTime movie recording. For use with 
Qd3d/3dPane or in 2d settings. All work with C++ 
compilers or ThinkC 6. $192 


NEW! QG™ by Onyx Technology, is a system 


extension that stress tests code during runtime 
for common and not-so-common errors. Tests include 
heap checks, purges, scrambles, handle/pointer 
validation, dispose/release checks, write to zero, de- 
reference zero as well as other tests like free memory 
invalidation and block bounds checking. QC is 
extremely user friendly for the non-technical tester yet 
offers an API for programmers who want precise control 
over testing. $99 


NEW! QUED/M 2.7 by Nisus Software, is a 
programmer's text editor which has defined the 
industry standard for speed and efficiency. With integrated 
support for Symantec C/C++, Metrowerks CodeWarrior, 
and MPW, QUED/M offers unrivaled usefulness for the 
Macintosh developer. In addition to supporting all the 
major development environments on the Macintosh, 
QUED/M offers dozens of powerful editing features, 
including unlimited undo and redo, UNIX style GREP 
searching, macro language, scripting, text folding, text 
sorting, file comparison and merging, Toolbox lookup, 
ten editable/appendable clipboards, line numbering, 
markers, displaying text as ASCII codes, vertical and 
horizontal screen splitting, plus much more. $149 


ScriptGen Pro™ by StepUp Software is an Installer 
script generator which requires no programming or 





knowledge of Rez. Supports StepUp’s InstallerPack, 


Stufflt compression, custom packages, splash screens, 
network installs, Rez code output, importing resources, 
and AppleEvent link w/MPW: $169 


SoftPolish by Language Systems is a development 
tool that helps software developers avoid embarrassing 
spelling errors, detect incorrect or incompatible resources 
and improve the appearance of their Macintosh software. 
SoftPolish examines application resources and reports 
potential problems to a scrolling log. Independent of any 





programming language or environment, t, SoftPolish 
improves the quality of any Macintosh program. $169 


NEW! Spyer by InCider is a simple operated tool 
ue records all actions (including mouse 


movement) you perform on a Macintosh computer and 
then replays them at your preferred speed. The recorded 
data can be saved in files for future use. Spyer works as a 
background process with any Macintosh application and 
is triggered by user defined Hot Keys. Spyer enables the 
"Continuous Redo" utility and is especially useful for 
software testing and demonstration. $39 


StoneTable: A library replacing all functions found in 
list manager plus: variable size columns/rows; different 
font, size, style, forecolor, backcolor per cell; sort, resize, 
move, copy, hide columns/rows; edit cells/titles in place; 
titles for columns/rows; multiple lines per cell; grid line 
pattern/color; greater than 32k data per table; up to 32k 
text per cell; support for balloon help and binary cell data. 
Versions for Think C, Think Pascal, MPW C, MPW 
Pascal, CodeWarrior C. (all prices per developer) $150 
first compiler, additional compilers $50 


Stone Table Extra: Additional functions for 
StoneTable. Drag selected cells within table or to other 
tables; optionally add rows as part of drag; popup menus 
or check boxes in cells; variable width grid lines; 
move/drag/resize table in window; clipboard operations 
on multiple cells. Requires StoneTable. (all prices per 
developer) $50 first compiler, additional compilers $25 


StoneTable and StoneTableExtra for 

PowerPG: Same functionality as 68K 
libraries. Versions for MPW C and CodeWarrior C. Must 
have 68K libraries. (all prices per developer) StoneTable 
$100, StoneTableExtra $25 


ViperBase by Viper Development is a fast database 
designed for developers that want speed but don’t want to 
spend months or years developing a commercial quality 
database. ViperBase: Unlimited Records, Variable Length: 
$59. ViperBase II: ViperBase + Multiple Indices. $119 


SOFTWARE FOR SALE? 


List your product in MacTech 
Magazine’s Mail Order Store. 


For more information, call: 
310/575-4343 
Fax: 310/575-0925 


AppleLink, GEnie & America 
Online: MACTECHMAG 


Voice: 


CompuServe: 71333,1064 


Internet: marketing@xplain.com 





Want more product info? Call us at 310/575-4343. 
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Send us your tips or you'll 
never see your backups alive! 


: eS Well, ok, we haven't touched 


your tips. We pay $25 for each 
tip we use, twice that for Tip of 
the Month. You can take your 
award in goods, subscriptions or 
US dollars. Make sure your code 
compiles, and send tips (and — 


= your backups, but we still want | | 


Jasik Designs won't work because f 
its supposed to be. Sorry about that 
simply a tool to be used in special 

able to expect system products of their nat 
bout the ROM. : 

werMac sometimes doesn’t work. He I have run into several things which 

set button again; it usually works the se change a file’s creator, but the finder 

ROM can be written to now, errant code coul doesn’t update the file’s icon right away. 

he Debugger can’t help out with it’s” The user often has to close and reopen the 

ometimes it’s worth making the tradeo Finder window to get the proper icons to 

: : y pre appear. If your application needs to fiddle | 

with a file’s creator type or other 

attributes, you can solve the above 

problem by changing the ioDrMdDat field 

of your file’s parent directory. This “tricks” 

the Finder into updating the window. | 





Hey, FINDER, PAy ATTENTION! 











void ForceFinderToUpdateFilelcon ( 
FSSpecPtr theFile) 

{ 

CInfoPBRec tempPB; 


if(theFile != OL) 
{ 
tempPB.dirInfo.ioNamePtr = OL; 
tempPB.dirInfo.ioVRefNum =theFile->vRefNum; 
tempPB.dirInfo.ioFDirIndex = -1; 











Copy Bits QUICKER | tempPB.dirInfo.ioDrDirID = theFile->parID; | 
4 
If you are using custom color palettes in combination with lots of calls to CopyBits, you can if (PBGetCatInfoSync (&tempPB) == noErr) 
speed up your graphics routines by making sure that the ctSeed of both the source and 
se tempPB.dirInfo.ioDrMdDat = LMGetTime(); 
destination PixMap’s color tables are the same. tempPB.dirInfo.ioDrDirID = theFile->parID; 
If the ctSeed values are different, QuickDraw will map each color in the source color PBSetCatInfoSync (&tempPB) ; 


} 
table to colors in the destination color table, slowing down the CopyBits operation. If the 


ctSeed values are the same, QuickDraw will assume that both PixMaps use the same color 
table, and it will simply copy the bits directly. This has the disadvantage that if the palettes — Craig Marciniak 
are completely different, you will end up with the wrong colors in the destination. TemplarDev@aol.com 

— Jeremy Vineyard, jeremyv@farallon.com 
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Agents Object System (AO/S): 
Delivering Component-based Technology 


SmalltalkAgents is a set of development and authoring - 

components built on the Agents Object System™ | 
(AO/S™"). The AO/S Component Toolbox™ is a ee : 
portable layer of abstraction between AO/S | which defined the OOP concept, and is now the cor- 
Components and host system services. The AOS | porate language of choice for new business applica- 
delivers a user extensible home/container that trans- ___ tions and sophisticated client/server systems. 


parently wrappers a variety of component technolo- | _ : | What this means to you! 


gies including OpenDoc, OLE, and OSA Scripting, SmalltalkAgents Professional, built on the unique 


Racine nna 


AO/S: Core Technologies s AO/S architecture, is a modern, innovative new 
The AO/S Core Technologies include rich intelligent development system that blends the best of 
component and agent support, vendor independent | _ component-based architecture with the best in 
database services, concurrent application support | __ Object-oriented development technologies. 


(much like the Apple Finder), separate user interface! what the press and customers say: 


threads enabling both tethered development and «__... the most unique and innovative 


) 


robust “memory protected” application Smalltalk development environment... 


deployment, and a shareable object system, all of Object Magazine, October 1994 


which makes it ideal for high-performance client and | 
“I must say, this is NOT the Smalltalk of several years 


ago, and 1 AM TRULY IMPRESSED WITH WHAT YOU 
- _ HAVE ACCOMPLISHED!” | 

Unlike other” application builders”, the AO/S Product ES Tnios Independent Consultant, New York, NY 
Family (including SmalltalkAgents Professional and | — rr—“=E 


server applications. 


““SmalltalkAgents has been my favorite Smalltalk envi- 


VisualAgents) allows you to go from user-level script- 
ing to full professional-level system development and 


back. SmalltalkAgents is scalable, from the creation | 


of small and simple applica ions to sophisticated and 


complex multi-user systems. 
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